{"uid":"cap_tHV6lA7swYdelwbXx_anW","slug":"brainiac-macro-intelligence-surprise-calculator-a10ba8ce","name":"BRAINIAC Macro Intelligence Surprise Calculator","description":"Pay-per-call APIs for AI agents: OFAC sanctions screening, compliance checks, token security, and Base chain data via x402. No account. Fixed USDC price. MCP-ready.","url":"https://www.brainiac.software/api/v1/macro-intelligence/surprise-calculate?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"csv":{"type":"string","maxLength":200000},"asOf":{"type":"string","maxLength":40},"debt":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"amount":{"type":"number","maximum":1000000000000000,"minimum":0},"coupon":{"type":"number","maximum":100,"minimum":0},"source":{"type":"string","maxLength":160},"country":{"type":"string","maxLength":80},"currency":{"type":"string","maxLength":12},"instrument":{"type":"string","maxLength":160},"maturityDate":{"type":"string","maxLength":40}},"additionalProperties":false},"maxItems":500},"file":{"type":"object","required":["mediaType","fileBase64"],"properties":{"filename":{"type":"string","maxLength":180,"minLength":1},"mediaType":{"enum":["text/plain","text/csv","application/json"],"type":"string"},"fileBase64":{"type":"string","maxLength":12000000,"minLength":1}},"additionalProperties":false},"json":{"type":"string","maxLength":200000},"text":{"type":"string","maxLength":200000},"rates":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"asOf":{"type":"string","maxLength":40},"bank":{"type":"string","maxLength":160},"rate":{"type":"number","maximum":100,"minimum":-100},"source":{"type":"string","maxLength":160},"country":{"type":"string","maxLength":80},"previousRate":{"type":"number","maximum":100,"minimum":-100}},"additionalProperties":false},"maxItems":200},"events":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"date":{"type":"string","maxLength":40},"kind":{"type":"string","maxLength":80},"title":{"type":"string","maxLength":300},"source":{"type":"string","maxLength":160},"country":{"type":"string","maxLength":80}},"additionalProperties":false},"maxItems":200},"series":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"kind":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":200},"unit":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":160},"country":{"type":"string","maxLength":80},"frequency":{"type":"string","maxLength":40}},"additionalProperties":false},"maxItems":200},"tenors":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"asOf":{"type":"string","maxLength":40},"tenor":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":160},"country":{"type":"string","maxLength":80},"yieldPct":{"type":"number","maximum":100,"minimum":-100}},"additionalProperties":false},"maxItems":400},"releases":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"unit":{"type":"string","maxLength":40},"actual":{"type":"number","maximum":1000000000,"minimum":-1000000000},"period":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":160},"country":{"type":"string","maxLength":80},"previous":{"type":"number","maximum":1000000000,"minimum":-1000000000},"consensus":{"type":"number","maximum":1000000000,"minimum":-1000000000},"indicator":{"type":"string","maxLength":160},"releaseDate":{"type":"string","maxLength":40}},"additionalProperties":false},"maxItems":400},"worldBank":{"type":"object","properties":{"country":{"type":"string","maxLength":3,"minLength":2},"perPage":{"type":"integer","maximum":60,"minimum":1},"indicator":{"type":"string","maxLength":80,"minLength":3}},"additionalProperties":false},"commodities":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"date":{"type":"string","maxLength":40},"name":{"type":"string","maxLength":120},"unit":{"type":"string","maxLength":40},"price":{"type":"number","maximum":1000000000,"minimum":0},"source":{"type":"string","maxLength":160}},"additionalProperties":false},"maxItems":1000},"priceLevels":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"asOf":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":160},"country":{"type":"string","maxLength":80},"currency":{"type":"string","maxLength":12},"fxPerUsd":{"type":"number","maximum":1000000000,"minimum":0},"priceIndex":{"type":"number","maximum":1000000,"minimum":0}},"additionalProperties":false},"maxItems":200},"observations":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"date":{"type":"string","maxLength":40},"unit":{"type":"string","maxLength":40},"value":{"type":"number","maximum":1000000000000,"minimum":-1000000000000},"source":{"type":"string","maxLength":160},"country":{"type":"string","maxLength":80},"seriesId":{"type":"string","maxLength":80}},"additionalProperties":false},"maxItems":5000}}},"responseSchema":{"type":"json","example":{"items":[{"id":"REL-1","unit":"%","actual":2.8,"period":"2026-07","source":"","zScore":-1,"country":"US","surprise":-0.1,"consensus":2.9,"indicator":"CPI YoY","releaseDate":"2026-08-10","apiKeyRequired":false,"zScoreSupplied":true,"paidProviderUsed":false,"surpriseSupplied":true},{"id":"REL-2","unit":"%","actual":2.9,"period":"2026-08","source":"","zScore":0,"country":"US","surprise":0,"consensus":2.9,"indicator":"CPI YoY","releaseDate":"2026-09-10","apiKeyRequired":false,"zScoreSupplied":true,"paidProviderUsed":false,"surpriseSupplied":true},{"id":"REL-3","unit":"%","actual":3.1,"period":"2026-09","source":"","zScore":1,"country":"US","surprise":0.1,"consensus":3,"indicator":"CPI YoY","releaseDate":"2026-10-10","apiKeyRequired":false,"zScoreSupplied":true,"paidProviderUsed":false,"surpriseSupplied":true}],"status":"calculated","findings":[],"checkedAt":"2026-11-04T21:00:00.000Z","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."],"sampleCount":3,"publicSources":[],"surpriseStdev":0.1,"apiKeyRequired":false,"ratingAssigned":false,"causationClaimed":false,"paidProviderUsed":false,"surpriseStdevSupplied":true}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Vloj5822yq6MCW9M2Tr4l","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Calculates economic surprise scores and z-scores for macroeconomic data releases by comparing actual values against consensus forecasts across indicators, countries, and time periods.","exampleAgentPrompt":"Calculate the economic surprise score for the US CPI YoY release — the consensus was 2.9% and the actual came in at 2.8% for July 2026. I also want the z-score based on a historical standard deviation of 0.1%.","exampleUseCases":[{"title":"CPI surprise scoring for macro strategy","prompt":"I have three months of US CPI data where consensus was 2.9%, 2.9%, and 3.0% and actuals came in at 2.8%, 2.9%, and 3.1% — can you calculate the surprise and z-score for each release with period dates July, August, and September 2026?"},{"title":"Central bank rate decision surprise","prompt":"The Fed just announced a 25bps cut but the market consensus was for no change. Run an economic surprise calculation for this rate decision — treat the consensus as 5.25% and the actual as 5.00% for the US as of November 2026."},{"title":"Multi-country PMI surprise index","prompt":"I have a CSV of PMI releases for the US, Germany, and Japan with actual values and consensus forecasts for Q3 2026 — can you compute surprise scores and z-scores for each country so I can build a cross-country surprise index?"}],"resultDescription":"Returns an array of scored items each containing: indicator name, country, period, release date, actual value, consensus value, surprise (actual minus consensus), z-score, unit, and source. Also includes aggregate metadata: calculation status, standard deviation of surprises, sample count, public data sources used, and an extensive limitations disclaimer clarifying no paid data providers or invented values were used.","failureModes":["Missing consensus values cannot be imputed — surprise will be null or omitted","Malformed CSV or JSON input may cause parsing errors","Exceeding maxItems limits (500 debt, 200 rates/events) truncates input","No historical standard deviation supplied means z-score cannot be computed","Payment not received results in HTTP 402 response blocking execution","Unsupported mediaType in file upload returns validation error"],"whenToPreferThis":"Use this endpoint when you need a pay-per-call, no-account macroeconomic surprise computation that accepts richly structured inputs (rates, debt, events, series, raw CSV/JSON/text) and returns normalized surprise scores and z-scores with transparent limitations. Prefer over building your own calculation when you need quick, standardized scoring of actual-vs-consensus macro releases without connecting to paid data vendors. Best suited for agents that already have consensus and actual data and need the statistical scoring layer.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-12T12:33:22.847Z","isFirstParty":false,"canonicalSlug":"brainiac-macro-intelligence-surprise-calculator-a10ba8ce"}