{"openapi":"3.1.0","info":{"title":"Global Financial Markets & Macro Intelligence API","version":"1.0.0","description":"Compare central-bank rates, yield curves, inflation, releases, debt maturity and macro events from supplied public-format series, with optional key-free World Bank pulls. Paid with x402 exact USDC on Base. No account is required.","contact":{"email":"support@brainiac.software"},"x-guidance":"BRAINIAC.software is a pay-per-call API for software agents. No account or API key is required.\nPayment uses the x402 protocol with exact USDC on Base (chain id 8453). Each POST operation has a fixed USD price.\nHow to call an operation:\n1. POST a JSON body matching the operation's requestBody schema to the operation path. Include an Idempotency-Key header (64 hex characters, 32 random bytes).\n2. If you have not paid, the server responds 402 with payment requirements in the body. Pay the exact amount to the payTo address on Base.\n3. Retry the identical request with the same Idempotency-Key and add a payment-signature header containing the x402 payment payload. On success (200) the operation result is returned.\n4. Reuse the same Idempotency-Key only for retries of the same operation and request body; it will not be charged twice.\nAll outputs are compliance prechecks, drafts, or data lookups for human review. They are not official determinations, legal advice, identity confirmation, or certified filings. Verify time-sensitive or official data with the cited source before acting."},"servers":[{"url":"https://www.brainiac.software"}],"paths":{"/api/v1/macro-intelligence/central-bank-rate-compare":{"post":{"operationId":"compare_central_bank_rates","summary":"Compare central bank rates","description":"Compare supplied policy rates across countries and banks. Missing previous rates leave change blank rather than inventing values.","tags":["macro-intelligence"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"series":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":200},"country":{"type":"string","maxLength":80},"kind":{"type":"string","maxLength":80},"unit":{"type":"string","maxLength":40},"frequency":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"observations":{"maxItems":5000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"seriesId":{"type":"string","maxLength":80},"country":{"type":"string","maxLength":80},"date":{"type":"string","maxLength":40},"value":{"type":"number","minimum":-1000000000000,"maximum":1000000000000},"unit":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"rates":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"country":{"type":"string","maxLength":80},"bank":{"type":"string","maxLength":160},"asOf":{"type":"string","maxLength":40},"rate":{"type":"number","minimum":-100,"maximum":100},"previousRate":{"type":"number","minimum":-100,"maximum":100},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"tenors":{"maxItems":400,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"country":{"type":"string","maxLength":80},"asOf":{"type":"string","maxLength":40},"tenor":{"type":"string","maxLength":40},"yieldPct":{"type":"number","minimum":-100,"maximum":100},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"releases":{"maxItems":400,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"indicator":{"type":"string","maxLength":160},"country":{"type":"string","maxLength":80},"period":{"type":"string","maxLength":40},"releaseDate":{"type":"string","maxLength":40},"actual":{"type":"number","minimum":-1000000000,"maximum":1000000000},"consensus":{"type":"number","minimum":-1000000000,"maximum":1000000000},"previous":{"type":"number","minimum":-1000000000,"maximum":1000000000},"unit":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"priceLevels":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"country":{"type":"string","maxLength":80},"currency":{"type":"string","maxLength":12},"asOf":{"type":"string","maxLength":40},"priceIndex":{"type":"number","minimum":0,"maximum":1000000},"fxPerUsd":{"type":"number","minimum":0,"maximum":1000000000},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"debt":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"country":{"type":"string","maxLength":80},"instrument":{"type":"string","maxLength":160},"maturityDate":{"type":"string","maxLength":40},"amount":{"type":"number","minimum":0,"maximum":1000000000000000},"currency":{"type":"string","maxLength":12},"coupon":{"type":"number","minimum":0,"maximum":100},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"commodities":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":120},"date":{"type":"string","maxLength":40},"price":{"type":"number","minimum":0,"maximum":1000000000},"unit":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"events":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"date":{"type":"string","maxLength":40},"country":{"type":"string","maxLength":80},"title":{"type":"string","maxLength":300},"kind":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"worldBank":{"type":"object","properties":{"country":{"type":"string","minLength":2,"maxLength":3},"indicator":{"type":"string","minLength":3,"maxLength":80},"perPage":{"type":"integer","minimum":1,"maximum":60}},"additionalProperties":false},"asOf":{"type":"string","maxLength":40}},"additionalProperties":false},"example":{"rates":[{"id":"R-1","country":"US","bank":"Federal Reserve","asOf":"2026-09-17","rate":5.25,"previousRate":5.5,"source":"Caller-supplied Fed publication excerpt"},{"id":"R-2","country":"EA","bank":"ECB","asOf":"2026-09-11","rate":3.5,"previousRate":3.75,"source":"Caller-supplied ECB publication excerpt"},{"id":"R-3","country":"GB","bank":"Bank of England","asOf":"2026-09-18","rate":4.75,"previousRate":5,"source":"Caller-supplied BoE publication excerpt"}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"countryCount":{"type":"number"},"averageRate":{"type":"number"},"averageRateSupplied":{"type":"boolean"},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"country":{"type":"string"},"bank":{"type":"string"},"asOf":{"type":"string"},"rate":{"type":"number"},"rateSupplied":{"type":"boolean"},"previousRate":{"type":"number"},"previousRateSupplied":{"type":"boolean"},"changePctPoints":{"type":"number"},"changePctPointsSupplied":{"type":"boolean"},"source":{"type":"string"},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"}},"additionalProperties":true}},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"},"ratingAssigned":{"type":"boolean"},"causationClaimed":{"type":"boolean"},"publicSources":{"type":"array","items":{}},"findings":{"type":"array","items":{}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-04T21:00:00.000Z","status":"compared","countryCount":3,"averageRate":4.5,"averageRateSupplied":true,"items":[{"id":"R-2","country":"EA","bank":"ECB","asOf":"2026-09-11","rate":3.5,"rateSupplied":true,"previousRate":3.75,"previousRateSupplied":true,"changePctPoints":-0.25,"changePctPointsSupplied":true,"source":"Caller-supplied ECB publication excerpt","paidProviderUsed":false,"apiKeyRequired":false},{"id":"R-3","country":"GB","bank":"Bank of England","asOf":"2026-09-18","rate":4.75,"rateSupplied":true,"previousRate":5,"previousRateSupplied":true,"changePctPoints":-0.25,"changePctPointsSupplied":true,"source":"Caller-supplied BoE publication excerpt","paidProviderUsed":false,"apiKeyRequired":false},{"id":"R-1","country":"US","bank":"Federal Reserve","asOf":"2026-09-17","rate":5.25,"rateSupplied":true,"previousRate":5.5,"previousRateSupplied":true,"changePctPoints":-0.25,"changePctPointsSupplied":true,"source":"Caller-supplied Fed publication excerpt","paidProviderUsed":false,"apiKeyRequired":false}],"paidProviderUsed":false,"apiKeyRequired":false,"ratingAssigned":false,"causationClaimed":false,"publicSources":[],"findings":[],"limitations":["Observations, rates, yields, releases, debt, commodities, and events are copied only from labeled fields supplied by the caller, or from key-free public World Bank responses when requested.","No paid financial data provider is used and no API key is required.","Missing consensus, previous values, FX rates, and debt amounts are not invented.","Country risk labels summarize supplied indicators only and are not a credit rating.","Event impact timelines link supplied events to nearby observation dates; causation is not claimed."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.04"},"protocols":[{"x402":{}}]}}},"/api/v1/macro-intelligence/yield-curve-analyze":{"post":{"operationId":"analyze_yield_curves","summary":"Analyze yield curves","description":"Analyze supplied sovereign yield tenors for slope, curvature, and curve shape without inventing missing points.","tags":["macro-intelligence"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"series":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":200},"country":{"type":"string","maxLength":80},"kind":{"type":"string","maxLength":80},"unit":{"type":"string","maxLength":40},"frequency":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"observations":{"maxItems":5000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"seriesId":{"type":"string","maxLength":80},"country":{"type":"string","maxLength":80},"date":{"type":"string","maxLength":40},"value":{"type":"number","minimum":-1000000000000,"maximum":1000000000000},"unit":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"rates":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"country":{"type":"string","maxLength":80},"bank":{"type":"string","maxLength":160},"asOf":{"type":"string","maxLength":40},"rate":{"type":"number","minimum":-100,"maximum":100},"previousRate":{"type":"number","minimum":-100,"maximum":100},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"tenors":{"maxItems":400,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"country":{"type":"string","maxLength":80},"asOf":{"type":"string","maxLength":40},"tenor":{"type":"string","maxLength":40},"yieldPct":{"type":"number","minimum":-100,"maximum":100},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"releases":{"maxItems":400,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"indicator":{"type":"string","maxLength":160},"country":{"type":"string","maxLength":80},"period":{"type":"string","maxLength":40},"releaseDate":{"type":"string","maxLength":40},"actual":{"type":"number","minimum":-1000000000,"maximum":1000000000},"consensus":{"type":"number","minimum":-1000000000,"maximum":1000000000},"previous":{"type":"number","minimum":-1000000000,"maximum":1000000000},"unit":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"priceLevels":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"country":{"type":"string","maxLength":80},"currency":{"type":"string","maxLength":12},"asOf":{"type":"string","maxLength":40},"priceIndex":{"type":"number","minimum":0,"maximum":1000000},"fxPerUsd":{"type":"number","minimum":0,"maximum":1000000000},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"debt":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"country":{"type":"string","maxLength":80},"instrument":{"type":"string","maxLength":160},"maturityDate":{"type":"string","maxLength":40},"amount":{"type":"number","minimum":0,"maximum":1000000000000000},"currency":{"type":"string","maxLength":12},"coupon":{"type":"number","minimum":0,"maximum":100},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"commodities":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":120},"date":{"type":"string","maxLength":40},"price":{"type":"number","minimum":0,"maximum":1000000000},"unit":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"events":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"date":{"type":"string","maxLength":40},"country":{"type":"string","maxLength":80},"title":{"type":"string","maxLength":300},"kind":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"worldBank":{"type":"object","properties":{"country":{"type":"string","minLength":2,"maxLength":3},"indicator":{"type":"string","minLength":3,"maxLength":80},"perPage":{"type":"integer","minimum":1,"maximum":60}},"additionalProperties":false},"asOf":{"type":"string","maxLength":40}},"additionalProperties":false},"example":{"tenors":[{"country":"US","asOf":"2026-10-01","tenor":"2y","yieldPct":3.8,"source":"Caller-supplied Treasury curve"},{"country":"US","asOf":"2026-10-01","tenor":"10y","yieldPct":4.2,"source":"Caller-supplied Treasury curve"},{"country":"US","asOf":"2026-10-01","tenor":"30y","yieldPct":4.5,"source":"Caller-supplied Treasury curve"}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"items":{"type":"array","items":{"type":"object","properties":{"country":{"type":"string"},"asOf":{"type":"string"},"pointCount":{"type":"number"},"shortTenor":{"type":"string"},"longTenor":{"type":"string"},"shortYield":{"type":"number"},"shortYieldSupplied":{"type":"boolean"},"longYield":{"type":"number"},"longYieldSupplied":{"type":"boolean"},"slopePctPoints":{"type":"number"},"slopePctPointsSupplied":{"type":"boolean"},"curvaturePctPoints":{"type":"number"},"curvaturePctPointsSupplied":{"type":"boolean"},"shape":{"type":"string"},"points":{"type":"array","items":{"type":"object","properties":{"tenor":{"type":"string"},"months":{"type":"number"},"yieldPct":{"type":"number"},"source":{"type":"string"}},"additionalProperties":true}},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"}},"additionalProperties":true}},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"},"ratingAssigned":{"type":"boolean"},"causationClaimed":{"type":"boolean"},"publicSources":{"type":"array","items":{}},"findings":{"type":"array","items":{}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-04T21:00:00.000Z","status":"analyzed","items":[{"country":"US","asOf":"2026-10-01","pointCount":3,"shortTenor":"2y","longTenor":"30y","shortYield":3.8,"shortYieldSupplied":true,"longYield":4.5,"longYieldSupplied":true,"slopePctPoints":0.7,"slopePctPointsSupplied":true,"curvaturePctPoints":-0.7,"curvaturePctPointsSupplied":true,"shape":"upward","points":[{"tenor":"2y","months":24,"yieldPct":3.8,"source":"Caller-supplied Treasury curve"},{"tenor":"10y","months":120,"yieldPct":4.2,"source":"Caller-supplied Treasury curve"},{"tenor":"30y","months":360,"yieldPct":4.5,"source":"Caller-supplied Treasury curve"}],"paidProviderUsed":false,"apiKeyRequired":false}],"paidProviderUsed":false,"apiKeyRequired":false,"ratingAssigned":false,"causationClaimed":false,"publicSources":[],"findings":[],"limitations":["Observations, rates, yields, releases, debt, commodities, and events are copied only from labeled fields supplied by the caller, or from key-free public World Bank responses when requested.","No paid financial data provider is used and no API key is required.","Missing consensus, previous values, FX rates, and debt amounts are not invented.","Country risk labels summarize supplied indicators only and are not a credit rating.","Event impact timelines link supplied events to nearby observation dates; causation is not claimed."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{}}]}}},"/api/v1/macro-intelligence/inflation-series-compare":{"post":{"operationId":"compare_inflation_series","summary":"Compare inflation series","description":"Compare supplied CPI or inflation observations by country using the latest and previous points only.","tags":["macro-intelligence"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"series":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":200},"country":{"type":"string","maxLength":80},"kind":{"type":"string","maxLength":80},"unit":{"type":"string","maxLength":40},"frequency":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"observations":{"maxItems":5000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"seriesId":{"type":"string","maxLength":80},"country":{"type":"string","maxLength":80},"date":{"type":"string","maxLength":40},"value":{"type":"number","minimum":-1000000000000,"maximum":1000000000000},"unit":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"rates":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"country":{"type":"string","maxLength":80},"bank":{"type":"string","maxLength":160},"asOf":{"type":"string","maxLength":40},"rate":{"type":"number","minimum":-100,"maximum":100},"previousRate":{"type":"number","minimum":-100,"maximum":100},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"tenors":{"maxItems":400,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"country":{"type":"string","maxLength":80},"asOf":{"type":"string","maxLength":40},"tenor":{"type":"string","maxLength":40},"yieldPct":{"type":"number","minimum":-100,"maximum":100},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"releases":{"maxItems":400,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"indicator":{"type":"string","maxLength":160},"country":{"type":"string","maxLength":80},"period":{"type":"string","maxLength":40},"releaseDate":{"type":"string","maxLength":40},"actual":{"type":"number","minimum":-1000000000,"maximum":1000000000},"consensus":{"type":"number","minimum":-1000000000,"maximum":1000000000},"previous":{"type":"number","minimum":-1000000000,"maximum":1000000000},"unit":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"priceLevels":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"country":{"type":"string","maxLength":80},"currency":{"type":"string","maxLength":12},"asOf":{"type":"string","maxLength":40},"priceIndex":{"type":"number","minimum":0,"maximum":1000000},"fxPerUsd":{"type":"number","minimum":0,"maximum":1000000000},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"debt":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"country":{"type":"string","maxLength":80},"instrument":{"type":"string","maxLength":160},"maturityDate":{"type":"string","maxLength":40},"amount":{"type":"number","minimum":0,"maximum":1000000000000000},"currency":{"type":"string","maxLength":12},"coupon":{"type":"number","minimum":0,"maximum":100},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"commodities":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":120},"date":{"type":"string","maxLength":40},"price":{"type":"number","minimum":0,"maximum":1000000000},"unit":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"events":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"date":{"type":"string","maxLength":40},"country":{"type":"string","maxLength":80},"title":{"type":"string","maxLength":300},"kind":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"worldBank":{"type":"object","properties":{"country":{"type":"string","minLength":2,"maxLength":3},"indicator":{"type":"string","minLength":3,"maxLength":80},"perPage":{"type":"integer","minimum":1,"maximum":60}},"additionalProperties":false},"asOf":{"type":"string","maxLength":40}},"additionalProperties":false},"example":{"series":[{"id":"CPI-US","name":"US CPI YoY","country":"US","kind":"inflation","unit":"%"}],"observations":[{"seriesId":"CPI-US","country":"US","date":"2026-08","value":2.9,"unit":"%","source":"Caller-supplied BLS excerpt"},{"seriesId":"CPI-US","country":"US","date":"2026-09","value":3.1,"unit":"%","source":"Caller-supplied BLS excerpt"},{"seriesId":"CPI-EA","country":"EA","date":"2026-08","value":2.1,"unit":"%","source":"Caller-supplied Eurostat excerpt"},{"seriesId":"CPI-EA","country":"EA","date":"2026-09","value":2,"unit":"%","source":"Caller-supplied Eurostat excerpt"}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"items":{"type":"array","items":{"type":"object","properties":{"country":{"type":"string"},"observationCount":{"type":"number"},"latestDate":{"type":"string"},"latestValue":{"type":"number"},"latestValueSupplied":{"type":"boolean"},"previousDate":{"type":"string"},"previousValue":{"type":"number"},"previousValueSupplied":{"type":"boolean"},"change":{"type":"number"},"changeSupplied":{"type":"boolean"},"unit":{"type":"string"},"source":{"type":"string"},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"}},"additionalProperties":true}},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"},"ratingAssigned":{"type":"boolean"},"causationClaimed":{"type":"boolean"},"publicSources":{"type":"array","items":{}},"findings":{"type":"array","items":{}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-04T21:00:00.000Z","status":"compared","items":[{"country":"US","observationCount":2,"latestDate":"2026-09","latestValue":3.1,"latestValueSupplied":true,"previousDate":"2026-08","previousValue":2.9,"previousValueSupplied":true,"change":0.2,"changeSupplied":true,"unit":"%","source":"Caller-supplied BLS excerpt","paidProviderUsed":false,"apiKeyRequired":false},{"country":"EA","observationCount":2,"latestDate":"2026-09","latestValue":2,"latestValueSupplied":true,"previousDate":"2026-08","previousValue":2.1,"previousValueSupplied":true,"change":-0.1,"changeSupplied":true,"unit":"%","source":"Caller-supplied Eurostat excerpt","paidProviderUsed":false,"apiKeyRequired":false}],"paidProviderUsed":false,"apiKeyRequired":false,"ratingAssigned":false,"causationClaimed":false,"publicSources":[],"findings":[],"limitations":["Observations, rates, yields, releases, debt, commodities, and events are copied only from labeled fields supplied by the caller, or from key-free public World Bank responses when requested.","No paid financial data provider is used and no API key is required.","Missing consensus, previous values, FX rates, and debt amounts are not invented.","Country risk labels summarize supplied indicators only and are not a credit rating.","Event impact timelines link supplied events to nearby observation dates; causation is not claimed."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.04"},"protocols":[{"x402":{}}]}}},"/api/v1/macro-intelligence/economic-indicator-release-track":{"post":{"operationId":"track_economic_indicator_releases","summary":"Track economic indicator releases","description":"Track supplied indicator release dates with actual, consensus, and previous values when present.","tags":["macro-intelligence"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"series":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":200},"country":{"type":"string","maxLength":80},"kind":{"type":"string","maxLength":80},"unit":{"type":"string","maxLength":40},"frequency":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"observations":{"maxItems":5000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"seriesId":{"type":"string","maxLength":80},"country":{"type":"string","maxLength":80},"date":{"type":"string","maxLength":40},"value":{"type":"number","minimum":-1000000000000,"maximum":1000000000000},"unit":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"rates":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"country":{"type":"string","maxLength":80},"bank":{"type":"string","maxLength":160},"asOf":{"type":"string","maxLength":40},"rate":{"type":"number","minimum":-100,"maximum":100},"previousRate":{"type":"number","minimum":-100,"maximum":100},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"tenors":{"maxItems":400,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"country":{"type":"string","maxLength":80},"asOf":{"type":"string","maxLength":40},"tenor":{"type":"string","maxLength":40},"yieldPct":{"type":"number","minimum":-100,"maximum":100},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"releases":{"maxItems":400,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"indicator":{"type":"string","maxLength":160},"country":{"type":"string","maxLength":80},"period":{"type":"string","maxLength":40},"releaseDate":{"type":"string","maxLength":40},"actual":{"type":"number","minimum":-1000000000,"maximum":1000000000},"consensus":{"type":"number","minimum":-1000000000,"maximum":1000000000},"previous":{"type":"number","minimum":-1000000000,"maximum":1000000000},"unit":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"priceLevels":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"country":{"type":"string","maxLength":80},"currency":{"type":"string","maxLength":12},"asOf":{"type":"string","maxLength":40},"priceIndex":{"type":"number","minimum":0,"maximum":1000000},"fxPerUsd":{"type":"number","minimum":0,"maximum":1000000000},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"debt":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"country":{"type":"string","maxLength":80},"instrument":{"type":"string","maxLength":160},"maturityDate":{"type":"string","maxLength":40},"amount":{"type":"number","minimum":0,"maximum":1000000000000000},"currency":{"type":"string","maxLength":12},"coupon":{"type":"number","minimum":0,"maximum":100},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"commodities":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":120},"date":{"type":"string","maxLength":40},"price":{"type":"number","minimum":0,"maximum":1000000000},"unit":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"events":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"date":{"type":"string","maxLength":40},"country":{"type":"string","maxLength":80},"title":{"type":"string","maxLength":300},"kind":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"worldBank":{"type":"object","properties":{"country":{"type":"string","minLength":2,"maxLength":3},"indicator":{"type":"string","minLength":3,"maxLength":80},"perPage":{"type":"integer","minimum":1,"maximum":60}},"additionalProperties":false},"asOf":{"type":"string","maxLength":40}},"additionalProperties":false},"example":{"releases":[{"id":"REL-1","indicator":"CPI YoY","country":"US","period":"2026-09","releaseDate":"2026-10-10","actual":3.1,"consensus":3,"previous":2.9,"unit":"%","source":"Caller-supplied release calendar"},{"id":"REL-2","indicator":"Unemployment","country":"US","period":"2026-09","releaseDate":"2026-10-03","actual":4.2,"consensus":4.2,"previous":4.1,"unit":"%","source":"Caller-supplied release calendar"}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"releaseCount":{"type":"number"},"withConsensusCount":{"type":"number"},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"indicator":{"type":"string"},"country":{"type":"string"},"period":{"type":"string"},"releaseDate":{"type":"string"},"actual":{"type":"number"},"actualSupplied":{"type":"boolean"},"consensus":{"type":"number"},"consensusSupplied":{"type":"boolean"},"previous":{"type":"number"},"previousSupplied":{"type":"boolean"},"surprise":{"type":"number"},"surpriseSupplied":{"type":"boolean"},"unit":{"type":"string"},"source":{"type":"string"},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"}},"additionalProperties":true}},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"},"ratingAssigned":{"type":"boolean"},"causationClaimed":{"type":"boolean"},"publicSources":{"type":"array","items":{}},"findings":{"type":"array","items":{}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-04T21:00:00.000Z","status":"tracked","releaseCount":2,"withConsensusCount":2,"items":[{"id":"REL-2","indicator":"Unemployment","country":"US","period":"2026-09","releaseDate":"2026-10-03","actual":4.2,"actualSupplied":true,"consensus":4.2,"consensusSupplied":true,"previous":4.1,"previousSupplied":true,"surprise":0,"surpriseSupplied":true,"unit":"%","source":"Caller-supplied release calendar","paidProviderUsed":false,"apiKeyRequired":false},{"id":"REL-1","indicator":"CPI YoY","country":"US","period":"2026-09","releaseDate":"2026-10-10","actual":3.1,"actualSupplied":true,"consensus":3,"consensusSupplied":true,"previous":2.9,"previousSupplied":true,"surprise":0.1,"surpriseSupplied":true,"unit":"%","source":"Caller-supplied release calendar","paidProviderUsed":false,"apiKeyRequired":false}],"paidProviderUsed":false,"apiKeyRequired":false,"ratingAssigned":false,"causationClaimed":false,"publicSources":[],"findings":[],"limitations":["Observations, rates, yields, releases, debt, commodities, and events are copied only from labeled fields supplied by the caller, or from key-free public World Bank responses when requested.","No paid financial data provider is used and no API key is required.","Missing consensus, previous values, FX rates, and debt amounts are not invented.","Country risk labels summarize supplied indicators only and are not a credit rating.","Event impact timelines link supplied events to nearby observation dates; causation is not claimed."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.04"},"protocols":[{"x402":{}}]}}},"/api/v1/macro-intelligence/surprise-calculate":{"post":{"operationId":"calculate_macro_surprises","summary":"Calculate macro surprises","description":"Calculate actual-minus-consensus surprises from supplied releases and optional z-scores against the sample stdev.","tags":["macro-intelligence"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"series":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":200},"country":{"type":"string","maxLength":80},"kind":{"type":"string","maxLength":80},"unit":{"type":"string","maxLength":40},"frequency":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"observations":{"maxItems":5000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"seriesId":{"type":"string","maxLength":80},"country":{"type":"string","maxLength":80},"date":{"type":"string","maxLength":40},"value":{"type":"number","minimum":-1000000000000,"maximum":1000000000000},"unit":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"rates":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"country":{"type":"string","maxLength":80},"bank":{"type":"string","maxLength":160},"asOf":{"type":"string","maxLength":40},"rate":{"type":"number","minimum":-100,"maximum":100},"previousRate":{"type":"number","minimum":-100,"maximum":100},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"tenors":{"maxItems":400,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"country":{"type":"string","maxLength":80},"asOf":{"type":"string","maxLength":40},"tenor":{"type":"string","maxLength":40},"yieldPct":{"type":"number","minimum":-100,"maximum":100},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"releases":{"maxItems":400,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"indicator":{"type":"string","maxLength":160},"country":{"type":"string","maxLength":80},"period":{"type":"string","maxLength":40},"releaseDate":{"type":"string","maxLength":40},"actual":{"type":"number","minimum":-1000000000,"maximum":1000000000},"consensus":{"type":"number","minimum":-1000000000,"maximum":1000000000},"previous":{"type":"number","minimum":-1000000000,"maximum":1000000000},"unit":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"priceLevels":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"country":{"type":"string","maxLength":80},"currency":{"type":"string","maxLength":12},"asOf":{"type":"string","maxLength":40},"priceIndex":{"type":"number","minimum":0,"maximum":1000000},"fxPerUsd":{"type":"number","minimum":0,"maximum":1000000000},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"debt":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"country":{"type":"string","maxLength":80},"instrument":{"type":"string","maxLength":160},"maturityDate":{"type":"string","maxLength":40},"amount":{"type":"number","minimum":0,"maximum":1000000000000000},"currency":{"type":"string","maxLength":12},"coupon":{"type":"number","minimum":0,"maximum":100},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"commodities":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":120},"date":{"type":"string","maxLength":40},"price":{"type":"number","minimum":0,"maximum":1000000000},"unit":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"events":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"date":{"type":"string","maxLength":40},"country":{"type":"string","maxLength":80},"title":{"type":"string","maxLength":300},"kind":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"worldBank":{"type":"object","properties":{"country":{"type":"string","minLength":2,"maxLength":3},"indicator":{"type":"string","minLength":3,"maxLength":80},"perPage":{"type":"integer","minimum":1,"maximum":60}},"additionalProperties":false},"asOf":{"type":"string","maxLength":40}},"additionalProperties":false},"example":{"releases":[{"indicator":"CPI YoY","country":"US","period":"2026-07","releaseDate":"2026-08-10","actual":2.8,"consensus":2.9,"unit":"%"},{"indicator":"CPI YoY","country":"US","period":"2026-08","releaseDate":"2026-09-10","actual":2.9,"consensus":2.9,"unit":"%"},{"indicator":"CPI YoY","country":"US","period":"2026-09","releaseDate":"2026-10-10","actual":3.1,"consensus":3,"unit":"%"}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"sampleCount":{"type":"number"},"surpriseStdev":{"type":"number"},"surpriseStdevSupplied":{"type":"boolean"},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"indicator":{"type":"string"},"country":{"type":"string"},"period":{"type":"string"},"releaseDate":{"type":"string"},"actual":{"type":"number"},"consensus":{"type":"number"},"surprise":{"type":"number"},"surpriseSupplied":{"type":"boolean"},"zScore":{"type":"number"},"zScoreSupplied":{"type":"boolean"},"unit":{"type":"string"},"source":{"type":"string"},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"}},"additionalProperties":true}},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"},"ratingAssigned":{"type":"boolean"},"causationClaimed":{"type":"boolean"},"publicSources":{"type":"array","items":{}},"findings":{"type":"array","items":{}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-04T21:00:00.000Z","status":"calculated","sampleCount":3,"surpriseStdev":0.1,"surpriseStdevSupplied":true,"items":[{"id":"REL-1","indicator":"CPI YoY","country":"US","period":"2026-07","releaseDate":"2026-08-10","actual":2.8,"consensus":2.9,"surprise":-0.1,"surpriseSupplied":true,"zScore":-1,"zScoreSupplied":true,"unit":"%","source":"","paidProviderUsed":false,"apiKeyRequired":false},{"id":"REL-2","indicator":"CPI YoY","country":"US","period":"2026-08","releaseDate":"2026-09-10","actual":2.9,"consensus":2.9,"surprise":0,"surpriseSupplied":true,"zScore":0,"zScoreSupplied":true,"unit":"%","source":"","paidProviderUsed":false,"apiKeyRequired":false},{"id":"REL-3","indicator":"CPI YoY","country":"US","period":"2026-09","releaseDate":"2026-10-10","actual":3.1,"consensus":3,"surprise":0.1,"surpriseSupplied":true,"zScore":1,"zScoreSupplied":true,"unit":"%","source":"","paidProviderUsed":false,"apiKeyRequired":false}],"paidProviderUsed":false,"apiKeyRequired":false,"ratingAssigned":false,"causationClaimed":false,"publicSources":[],"findings":[],"limitations":["Observations, rates, yields, releases, debt, commodities, and events are copied only from labeled fields supplied by the caller, or from key-free public World Bank responses when requested.","No paid financial data provider is used and no API key is required.","Missing consensus, previous values, FX rates, and debt amounts are not invented.","Country risk labels summarize supplied indicators only and are not a credit rating.","Event impact timelines link supplied events to nearby observation dates; causation is not claimed."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{}}]}}},"/api/v1/macro-intelligence/currency-purchasing-power-compare":{"post":{"operationId":"compare_currency_purchasing_power","summary":"Compare currency purchasing power","description":"Compare supplied price indexes adjusted by FX-per-USD values. Missing FX or price indexes are not invented.","tags":["macro-intelligence"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"series":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":200},"country":{"type":"string","maxLength":80},"kind":{"type":"string","maxLength":80},"unit":{"type":"string","maxLength":40},"frequency":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"observations":{"maxItems":5000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"seriesId":{"type":"string","maxLength":80},"country":{"type":"string","maxLength":80},"date":{"type":"string","maxLength":40},"value":{"type":"number","minimum":-1000000000000,"maximum":1000000000000},"unit":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"rates":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"country":{"type":"string","maxLength":80},"bank":{"type":"string","maxLength":160},"asOf":{"type":"string","maxLength":40},"rate":{"type":"number","minimum":-100,"maximum":100},"previousRate":{"type":"number","minimum":-100,"maximum":100},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"tenors":{"maxItems":400,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"country":{"type":"string","maxLength":80},"asOf":{"type":"string","maxLength":40},"tenor":{"type":"string","maxLength":40},"yieldPct":{"type":"number","minimum":-100,"maximum":100},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"releases":{"maxItems":400,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"indicator":{"type":"string","maxLength":160},"country":{"type":"string","maxLength":80},"period":{"type":"string","maxLength":40},"releaseDate":{"type":"string","maxLength":40},"actual":{"type":"number","minimum":-1000000000,"maximum":1000000000},"consensus":{"type":"number","minimum":-1000000000,"maximum":1000000000},"previous":{"type":"number","minimum":-1000000000,"maximum":1000000000},"unit":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"priceLevels":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"country":{"type":"string","maxLength":80},"currency":{"type":"string","maxLength":12},"asOf":{"type":"string","maxLength":40},"priceIndex":{"type":"number","minimum":0,"maximum":1000000},"fxPerUsd":{"type":"number","minimum":0,"maximum":1000000000},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"debt":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"country":{"type":"string","maxLength":80},"instrument":{"type":"string","maxLength":160},"maturityDate":{"type":"string","maxLength":40},"amount":{"type":"number","minimum":0,"maximum":1000000000000000},"currency":{"type":"string","maxLength":12},"coupon":{"type":"number","minimum":0,"maximum":100},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"commodities":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":120},"date":{"type":"string","maxLength":40},"price":{"type":"number","minimum":0,"maximum":1000000000},"unit":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"events":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"date":{"type":"string","maxLength":40},"country":{"type":"string","maxLength":80},"title":{"type":"string","maxLength":300},"kind":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"worldBank":{"type":"object","properties":{"country":{"type":"string","minLength":2,"maxLength":3},"indicator":{"type":"string","minLength":3,"maxLength":80},"perPage":{"type":"integer","minimum":1,"maximum":60}},"additionalProperties":false},"asOf":{"type":"string","maxLength":40}},"additionalProperties":false},"example":{"priceLevels":[{"country":"US","currency":"USD","asOf":"2026-01-01","priceIndex":100,"fxPerUsd":1,"source":"Caller-supplied price level"},{"country":"GB","currency":"GBP","asOf":"2026-01-01","priceIndex":95,"fxPerUsd":0.78,"source":"Caller-supplied price level"}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"pairCount":{"type":"number"},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"country":{"type":"string"},"currency":{"type":"string"},"asOf":{"type":"string"},"priceIndex":{"type":"number"},"priceIndexSupplied":{"type":"boolean"},"fxPerUsd":{"type":"number"},"fxPerUsdSupplied":{"type":"boolean"},"realIndex":{"type":"number"},"realIndexSupplied":{"type":"boolean"},"source":{"type":"string"},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"}},"additionalProperties":true}},"pairs":{"type":"array","items":{"type":"object","properties":{"leftCountry":{"type":"string"},"rightCountry":{"type":"string"},"leftRealIndex":{"type":"number"},"rightRealIndex":{"type":"number"},"ratio":{"type":"number"},"ratioSupplied":{"type":"boolean"},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"}},"additionalProperties":true}},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"},"ratingAssigned":{"type":"boolean"},"causationClaimed":{"type":"boolean"},"publicSources":{"type":"array","items":{}},"findings":{"type":"array","items":{}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-04T21:00:00.000Z","status":"compared","pairCount":1,"items":[{"id":"P-1","country":"US","currency":"USD","asOf":"2026-01-01","priceIndex":100,"priceIndexSupplied":true,"fxPerUsd":1,"fxPerUsdSupplied":true,"realIndex":100,"realIndexSupplied":true,"source":"Caller-supplied price level","paidProviderUsed":false,"apiKeyRequired":false},{"id":"P-2","country":"GB","currency":"GBP","asOf":"2026-01-01","priceIndex":95,"priceIndexSupplied":true,"fxPerUsd":0.78,"fxPerUsdSupplied":true,"realIndex":121.7949,"realIndexSupplied":true,"source":"Caller-supplied price level","paidProviderUsed":false,"apiKeyRequired":false}],"pairs":[{"leftCountry":"US","rightCountry":"GB","leftRealIndex":100,"rightRealIndex":121.7949,"ratio":0.8211,"ratioSupplied":true,"paidProviderUsed":false,"apiKeyRequired":false}],"paidProviderUsed":false,"apiKeyRequired":false,"ratingAssigned":false,"causationClaimed":false,"publicSources":[],"findings":[],"limitations":["Observations, rates, yields, releases, debt, commodities, and events are copied only from labeled fields supplied by the caller, or from key-free public World Bank responses when requested.","No paid financial data provider is used and no API key is required.","Missing consensus, previous values, FX rates, and debt amounts are not invented.","Country risk labels summarize supplied indicators only and are not a credit rating.","Event impact timelines link supplied events to nearby observation dates; causation is not claimed."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{}}]}}},"/api/v1/macro-intelligence/country-risk-profile":{"post":{"operationId":"profile_country_macro_risk","summary":"Profile country macro risk","description":"Summarize supplied inflation, policy rates, and debt into a descriptive risk level. This is not a credit rating.","tags":["macro-intelligence"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"series":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":200},"country":{"type":"string","maxLength":80},"kind":{"type":"string","maxLength":80},"unit":{"type":"string","maxLength":40},"frequency":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"observations":{"maxItems":5000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"seriesId":{"type":"string","maxLength":80},"country":{"type":"string","maxLength":80},"date":{"type":"string","maxLength":40},"value":{"type":"number","minimum":-1000000000000,"maximum":1000000000000},"unit":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"rates":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"country":{"type":"string","maxLength":80},"bank":{"type":"string","maxLength":160},"asOf":{"type":"string","maxLength":40},"rate":{"type":"number","minimum":-100,"maximum":100},"previousRate":{"type":"number","minimum":-100,"maximum":100},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"tenors":{"maxItems":400,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"country":{"type":"string","maxLength":80},"asOf":{"type":"string","maxLength":40},"tenor":{"type":"string","maxLength":40},"yieldPct":{"type":"number","minimum":-100,"maximum":100},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"releases":{"maxItems":400,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"indicator":{"type":"string","maxLength":160},"country":{"type":"string","maxLength":80},"period":{"type":"string","maxLength":40},"releaseDate":{"type":"string","maxLength":40},"actual":{"type":"number","minimum":-1000000000,"maximum":1000000000},"consensus":{"type":"number","minimum":-1000000000,"maximum":1000000000},"previous":{"type":"number","minimum":-1000000000,"maximum":1000000000},"unit":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"priceLevels":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"country":{"type":"string","maxLength":80},"currency":{"type":"string","maxLength":12},"asOf":{"type":"string","maxLength":40},"priceIndex":{"type":"number","minimum":0,"maximum":1000000},"fxPerUsd":{"type":"number","minimum":0,"maximum":1000000000},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"debt":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"country":{"type":"string","maxLength":80},"instrument":{"type":"string","maxLength":160},"maturityDate":{"type":"string","maxLength":40},"amount":{"type":"number","minimum":0,"maximum":1000000000000000},"currency":{"type":"string","maxLength":12},"coupon":{"type":"number","minimum":0,"maximum":100},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"commodities":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":120},"date":{"type":"string","maxLength":40},"price":{"type":"number","minimum":0,"maximum":1000000000},"unit":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"events":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"date":{"type":"string","maxLength":40},"country":{"type":"string","maxLength":80},"title":{"type":"string","maxLength":300},"kind":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"worldBank":{"type":"object","properties":{"country":{"type":"string","minLength":2,"maxLength":3},"indicator":{"type":"string","minLength":3,"maxLength":80},"perPage":{"type":"integer","minimum":1,"maximum":60}},"additionalProperties":false},"asOf":{"type":"string","maxLength":40}},"additionalProperties":false},"example":{"rates":[{"country":"US","bank":"Federal Reserve","asOf":"2026-09-17","rate":5.25,"source":"Caller-supplied"}],"observations":[{"seriesId":"CPI-US","country":"US","date":"2026-08","value":2.9,"unit":"%"},{"seriesId":"CPI-US","country":"US","date":"2026-09","value":3.1,"unit":"%"}],"debt":[{"country":"US","instrument":"UST","maturityDate":"2030-01-15","amount":500000000000,"currency":"USD","source":"Caller-supplied"}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"items":{"type":"array","items":{"type":"object","properties":{"country":{"type":"string"},"inflationLatest":{"type":"number"},"inflationLatestSupplied":{"type":"boolean"},"policyRate":{"type":"number"},"policyRateSupplied":{"type":"boolean"},"debtAmount":{"type":"number"},"debtAmountSupplied":{"type":"boolean"},"signalCount":{"type":"number"},"riskScore":{"type":"number"},"riskLevel":{"type":"string"},"ratingAssigned":{"type":"boolean"},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"}},"additionalProperties":true}},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"},"ratingAssigned":{"type":"boolean"},"causationClaimed":{"type":"boolean"},"publicSources":{"type":"array","items":{}},"findings":{"type":"array","items":{}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-04T21:00:00.000Z","status":"profiled","items":[{"country":"US","inflationLatest":3.1,"inflationLatestSupplied":true,"policyRate":5.25,"policyRateSupplied":true,"debtAmount":500000000000,"debtAmountSupplied":true,"signalCount":3,"riskScore":1,"riskLevel":"contained","ratingAssigned":false,"paidProviderUsed":false,"apiKeyRequired":false}],"paidProviderUsed":false,"apiKeyRequired":false,"ratingAssigned":false,"causationClaimed":false,"publicSources":[],"findings":[],"limitations":["Observations, rates, yields, releases, debt, commodities, and events are copied only from labeled fields supplied by the caller, or from key-free public World Bank responses when requested.","No paid financial data provider is used and no API key is required.","Missing consensus, previous values, FX rates, and debt amounts are not invented.","Country risk labels summarize supplied indicators only and are not a credit rating.","Event impact timelines link supplied events to nearby observation dates; causation is not claimed."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{}}]}}},"/api/v1/macro-intelligence/sovereign-debt-maturity-analyze":{"post":{"operationId":"analyze_sovereign_debt_maturity","summary":"Analyze sovereign debt maturity","description":"Bucket supplied sovereign debt amounts by maturity window from the as-of date without inventing missing maturities.","tags":["macro-intelligence"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"series":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":200},"country":{"type":"string","maxLength":80},"kind":{"type":"string","maxLength":80},"unit":{"type":"string","maxLength":40},"frequency":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"observations":{"maxItems":5000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"seriesId":{"type":"string","maxLength":80},"country":{"type":"string","maxLength":80},"date":{"type":"string","maxLength":40},"value":{"type":"number","minimum":-1000000000000,"maximum":1000000000000},"unit":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"rates":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"country":{"type":"string","maxLength":80},"bank":{"type":"string","maxLength":160},"asOf":{"type":"string","maxLength":40},"rate":{"type":"number","minimum":-100,"maximum":100},"previousRate":{"type":"number","minimum":-100,"maximum":100},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"tenors":{"maxItems":400,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"country":{"type":"string","maxLength":80},"asOf":{"type":"string","maxLength":40},"tenor":{"type":"string","maxLength":40},"yieldPct":{"type":"number","minimum":-100,"maximum":100},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"releases":{"maxItems":400,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"indicator":{"type":"string","maxLength":160},"country":{"type":"string","maxLength":80},"period":{"type":"string","maxLength":40},"releaseDate":{"type":"string","maxLength":40},"actual":{"type":"number","minimum":-1000000000,"maximum":1000000000},"consensus":{"type":"number","minimum":-1000000000,"maximum":1000000000},"previous":{"type":"number","minimum":-1000000000,"maximum":1000000000},"unit":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"priceLevels":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"country":{"type":"string","maxLength":80},"currency":{"type":"string","maxLength":12},"asOf":{"type":"string","maxLength":40},"priceIndex":{"type":"number","minimum":0,"maximum":1000000},"fxPerUsd":{"type":"number","minimum":0,"maximum":1000000000},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"debt":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"country":{"type":"string","maxLength":80},"instrument":{"type":"string","maxLength":160},"maturityDate":{"type":"string","maxLength":40},"amount":{"type":"number","minimum":0,"maximum":1000000000000000},"currency":{"type":"string","maxLength":12},"coupon":{"type":"number","minimum":0,"maximum":100},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"commodities":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":120},"date":{"type":"string","maxLength":40},"price":{"type":"number","minimum":0,"maximum":1000000000},"unit":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"events":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"date":{"type":"string","maxLength":40},"country":{"type":"string","maxLength":80},"title":{"type":"string","maxLength":300},"kind":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"worldBank":{"type":"object","properties":{"country":{"type":"string","minLength":2,"maxLength":3},"indicator":{"type":"string","minLength":3,"maxLength":80},"perPage":{"type":"integer","minimum":1,"maximum":60}},"additionalProperties":false},"asOf":{"type":"string","maxLength":40}},"additionalProperties":false},"example":{"asOf":"2026-10-01","debt":[{"country":"US","instrument":"Bill","maturityDate":"2026-12-15","amount":100,"currency":"USD","source":"Caller-supplied"},{"country":"US","instrument":"Note","maturityDate":"2029-05-15","amount":250,"currency":"USD","source":"Caller-supplied"},{"country":"US","instrument":"Bond","maturityDate":"2045-02-15","amount":400,"currency":"USD","source":"Caller-supplied"}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"items":{"type":"array","items":{"type":"object","properties":{"country":{"type":"string"},"asOf":{"type":"string"},"instrumentCount":{"type":"number"},"totalAmount":{"type":"number"},"totalAmountSupplied":{"type":"boolean"},"currency":{"type":"string"},"buckets":{"type":"array","items":{"type":"object","properties":{"bucket":{"type":"string"},"amount":{"type":"number"},"amountSupplied":{"type":"boolean"}},"additionalProperties":true}},"nearestMaturity":{"type":"string"},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"}},"additionalProperties":true}},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"},"ratingAssigned":{"type":"boolean"},"causationClaimed":{"type":"boolean"},"publicSources":{"type":"array","items":{}},"findings":{"type":"array","items":{}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-04T21:00:00.000Z","status":"analyzed","items":[{"country":"US","asOf":"2026-10-01","instrumentCount":3,"totalAmount":750,"totalAmountSupplied":true,"currency":"USD","buckets":[{"bucket":"0_12m","amount":100,"amountSupplied":true},{"bucket":"1_5y","amount":250,"amountSupplied":true},{"bucket":"5_10y","amount":0,"amountSupplied":true},{"bucket":"10y_plus","amount":400,"amountSupplied":true}],"nearestMaturity":"2026-12-15","paidProviderUsed":false,"apiKeyRequired":false}],"paidProviderUsed":false,"apiKeyRequired":false,"ratingAssigned":false,"causationClaimed":false,"publicSources":[],"findings":[],"limitations":["Observations, rates, yields, releases, debt, commodities, and events are copied only from labeled fields supplied by the caller, or from key-free public World Bank responses when requested.","No paid financial data provider is used and no API key is required.","Missing consensus, previous values, FX rates, and debt amounts are not invented.","Country risk labels summarize supplied indicators only and are not a credit rating.","Event impact timelines link supplied events to nearby observation dates; causation is not claimed."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.04"},"protocols":[{"x402":{}}]}}},"/api/v1/macro-intelligence/commodity-price-transmission-analyze":{"post":{"operationId":"analyze_commodity_price_transmission","summary":"Analyze commodity price transmission","description":"Compare supplied commodity price changes with inflation observation changes. Causation is not claimed.","tags":["macro-intelligence"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"series":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":200},"country":{"type":"string","maxLength":80},"kind":{"type":"string","maxLength":80},"unit":{"type":"string","maxLength":40},"frequency":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"observations":{"maxItems":5000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"seriesId":{"type":"string","maxLength":80},"country":{"type":"string","maxLength":80},"date":{"type":"string","maxLength":40},"value":{"type":"number","minimum":-1000000000000,"maximum":1000000000000},"unit":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"rates":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"country":{"type":"string","maxLength":80},"bank":{"type":"string","maxLength":160},"asOf":{"type":"string","maxLength":40},"rate":{"type":"number","minimum":-100,"maximum":100},"previousRate":{"type":"number","minimum":-100,"maximum":100},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"tenors":{"maxItems":400,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"country":{"type":"string","maxLength":80},"asOf":{"type":"string","maxLength":40},"tenor":{"type":"string","maxLength":40},"yieldPct":{"type":"number","minimum":-100,"maximum":100},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"releases":{"maxItems":400,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"indicator":{"type":"string","maxLength":160},"country":{"type":"string","maxLength":80},"period":{"type":"string","maxLength":40},"releaseDate":{"type":"string","maxLength":40},"actual":{"type":"number","minimum":-1000000000,"maximum":1000000000},"consensus":{"type":"number","minimum":-1000000000,"maximum":1000000000},"previous":{"type":"number","minimum":-1000000000,"maximum":1000000000},"unit":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"priceLevels":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"country":{"type":"string","maxLength":80},"currency":{"type":"string","maxLength":12},"asOf":{"type":"string","maxLength":40},"priceIndex":{"type":"number","minimum":0,"maximum":1000000},"fxPerUsd":{"type":"number","minimum":0,"maximum":1000000000},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"debt":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"country":{"type":"string","maxLength":80},"instrument":{"type":"string","maxLength":160},"maturityDate":{"type":"string","maxLength":40},"amount":{"type":"number","minimum":0,"maximum":1000000000000000},"currency":{"type":"string","maxLength":12},"coupon":{"type":"number","minimum":0,"maximum":100},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"commodities":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":120},"date":{"type":"string","maxLength":40},"price":{"type":"number","minimum":0,"maximum":1000000000},"unit":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"events":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"date":{"type":"string","maxLength":40},"country":{"type":"string","maxLength":80},"title":{"type":"string","maxLength":300},"kind":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"worldBank":{"type":"object","properties":{"country":{"type":"string","minLength":2,"maxLength":3},"indicator":{"type":"string","minLength":3,"maxLength":80},"perPage":{"type":"integer","minimum":1,"maximum":60}},"additionalProperties":false},"asOf":{"type":"string","maxLength":40}},"additionalProperties":false},"example":{"commodities":[{"name":"Brent","date":"2026-08-01","price":80,"unit":"USD/bbl","source":"Caller-supplied"},{"name":"Brent","date":"2026-09-01","price":88,"unit":"USD/bbl","source":"Caller-supplied"}],"observations":[{"seriesId":"CPI-US","country":"US","date":"2026-08","value":2.9,"unit":"%"},{"seriesId":"CPI-US","country":"US","date":"2026-09","value":3.1,"unit":"%"}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"items":{"type":"array","items":{"type":"object","properties":{"commodity":{"type":"string"},"unit":{"type":"string"},"pointCount":{"type":"number"},"startDate":{"type":"string"},"endDate":{"type":"string"},"startPrice":{"type":"number"},"endPrice":{"type":"number"},"changePct":{"type":"number"},"changePctSupplied":{"type":"boolean"},"inflationLinks":{"type":"array","items":{"type":"object","properties":{"country":{"type":"string"},"inflationChange":{"type":"number"},"inflationChangeSupplied":{"type":"boolean"},"commodityChangePct":{"type":"number"},"commodityChangePctSupplied":{"type":"boolean"},"sameDirection":{"type":"boolean"}},"additionalProperties":true}},"causationClaimed":{"type":"boolean"},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"}},"additionalProperties":true}},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"},"ratingAssigned":{"type":"boolean"},"causationClaimed":{"type":"boolean"},"publicSources":{"type":"array","items":{}},"findings":{"type":"array","items":{}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-04T21:00:00.000Z","status":"analyzed","items":[{"commodity":"Brent","unit":"USD/bbl","pointCount":2,"startDate":"2026-08-01","endDate":"2026-09-01","startPrice":80,"endPrice":88,"changePct":0.1,"changePctSupplied":true,"inflationLinks":[{"country":"US","inflationChange":0.2,"inflationChangeSupplied":true,"commodityChangePct":0.1,"commodityChangePctSupplied":true,"sameDirection":true}],"causationClaimed":false,"paidProviderUsed":false,"apiKeyRequired":false}],"paidProviderUsed":false,"apiKeyRequired":false,"ratingAssigned":false,"causationClaimed":false,"publicSources":[],"findings":[],"limitations":["Observations, rates, yields, releases, debt, commodities, and events are copied only from labeled fields supplied by the caller, or from key-free public World Bank responses when requested.","No paid financial data provider is used and no API key is required.","Missing consensus, previous values, FX rates, and debt amounts are not invented.","Country risk labels summarize supplied indicators only and are not a credit rating.","Event impact timelines link supplied events to nearby observation dates; causation is not claimed."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{}}]}}},"/api/v1/macro-intelligence/event-impact-timeline":{"post":{"operationId":"build_macro_event_impact_timeline","summary":"Build macro event impact timeline","description":"Place supplied macro events on a timeline and attach nearby observations within 45 days. Causation is not claimed.","tags":["macro-intelligence"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"series":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":200},"country":{"type":"string","maxLength":80},"kind":{"type":"string","maxLength":80},"unit":{"type":"string","maxLength":40},"frequency":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"observations":{"maxItems":5000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"seriesId":{"type":"string","maxLength":80},"country":{"type":"string","maxLength":80},"date":{"type":"string","maxLength":40},"value":{"type":"number","minimum":-1000000000000,"maximum":1000000000000},"unit":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"rates":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"country":{"type":"string","maxLength":80},"bank":{"type":"string","maxLength":160},"asOf":{"type":"string","maxLength":40},"rate":{"type":"number","minimum":-100,"maximum":100},"previousRate":{"type":"number","minimum":-100,"maximum":100},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"tenors":{"maxItems":400,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"country":{"type":"string","maxLength":80},"asOf":{"type":"string","maxLength":40},"tenor":{"type":"string","maxLength":40},"yieldPct":{"type":"number","minimum":-100,"maximum":100},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"releases":{"maxItems":400,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"indicator":{"type":"string","maxLength":160},"country":{"type":"string","maxLength":80},"period":{"type":"string","maxLength":40},"releaseDate":{"type":"string","maxLength":40},"actual":{"type":"number","minimum":-1000000000,"maximum":1000000000},"consensus":{"type":"number","minimum":-1000000000,"maximum":1000000000},"previous":{"type":"number","minimum":-1000000000,"maximum":1000000000},"unit":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"priceLevels":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"country":{"type":"string","maxLength":80},"currency":{"type":"string","maxLength":12},"asOf":{"type":"string","maxLength":40},"priceIndex":{"type":"number","minimum":0,"maximum":1000000},"fxPerUsd":{"type":"number","minimum":0,"maximum":1000000000},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"debt":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"country":{"type":"string","maxLength":80},"instrument":{"type":"string","maxLength":160},"maturityDate":{"type":"string","maxLength":40},"amount":{"type":"number","minimum":0,"maximum":1000000000000000},"currency":{"type":"string","maxLength":12},"coupon":{"type":"number","minimum":0,"maximum":100},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"commodities":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":120},"date":{"type":"string","maxLength":40},"price":{"type":"number","minimum":0,"maximum":1000000000},"unit":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"events":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"date":{"type":"string","maxLength":40},"country":{"type":"string","maxLength":80},"title":{"type":"string","maxLength":300},"kind":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":160}},"additionalProperties":false}},"worldBank":{"type":"object","properties":{"country":{"type":"string","minLength":2,"maxLength":3},"indicator":{"type":"string","minLength":3,"maxLength":80},"perPage":{"type":"integer","minimum":1,"maximum":60}},"additionalProperties":false},"asOf":{"type":"string","maxLength":40}},"additionalProperties":false},"example":{"events":[{"id":"E-1","date":"2026-09-17","country":"US","title":"FOMC decision","kind":"policy","source":"Caller-supplied"}],"observations":[{"seriesId":"UST10","country":"US","date":"2026-09-01","value":4.1,"unit":"%"},{"seriesId":"UST10","country":"US","date":"2026-09-18","value":4,"unit":"%"},{"seriesId":"UST10","country":"US","date":"2026-10-01","value":4.05,"unit":"%"}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"eventCount":{"type":"number"},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"date":{"type":"string"},"country":{"type":"string"},"title":{"type":"string"},"kind":{"type":"string"},"source":{"type":"string"},"nearbyObservationCount":{"type":"number"},"nearbyObservations":{"type":"array","items":{"type":"object","properties":{"seriesId":{"type":"string"},"date":{"type":"string"},"value":{"type":"number"},"unit":{"type":"string"},"daysFromEvent":{"type":"number"}},"additionalProperties":true}},"causationClaimed":{"type":"boolean"},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"}},"additionalProperties":true}},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"},"ratingAssigned":{"type":"boolean"},"causationClaimed":{"type":"boolean"},"publicSources":{"type":"array","items":{}},"findings":{"type":"array","items":{}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-04T21:00:00.000Z","status":"timed","eventCount":1,"items":[{"id":"E-1","date":"2026-09-17","country":"US","title":"FOMC decision","kind":"policy","source":"Caller-supplied","nearbyObservationCount":3,"nearbyObservations":[{"seriesId":"UST10","date":"2026-09-01","value":4.1,"unit":"%","daysFromEvent":-16},{"seriesId":"UST10","date":"2026-09-18","value":4,"unit":"%","daysFromEvent":1},{"seriesId":"UST10","date":"2026-10-01","value":4.05,"unit":"%","daysFromEvent":14}],"causationClaimed":false,"paidProviderUsed":false,"apiKeyRequired":false}],"paidProviderUsed":false,"apiKeyRequired":false,"ratingAssigned":false,"causationClaimed":false,"publicSources":[],"findings":[],"limitations":["Observations, rates, yields, releases, debt, commodities, and events are copied only from labeled fields supplied by the caller, or from key-free public World Bank responses when requested.","No paid financial data provider is used and no API key is required.","Missing consensus, previous values, FX rates, and debt amounts are not invented.","Country risk labels summarize supplied indicators only and are not a credit rating.","Event impact timelines link supplied events to nearby observation dates; causation is not claimed."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{}}]}}}},"components":{"schemas":{"ApiError":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}}