{"uid":"cap_Dao9amb-H-GYJC6_2Jo81","slug":"x402-factory-us-economic-series-data-99e1f0cd","name":"x402-factory US Economic Series Data","description":"US economic series: latest print, revisions, surprise vs labeled expectation — One tracked US economic series (BLS/BEA/Fed/Census via FRED/ALFRED): the latest print with first-release vs latest value (revisions never masquerade as print-day numbers), surprise against a labeled expectation — market-implied when a matching prediction market exists, else a trend model — the next scheduled release…","url":"https://x402-factory.com/v1/econ/:series?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"pathParams":{"type":"object","required":["series"],"properties":{"series":{"type":"string","maxLength":30,"minLength":2,"description":"Series slug, e.g. cpi, core-cpi, payrolls (GET /v1/econ/calendar lists all)"}}},"queryParams":{"type":"object","properties":{}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["series","fred_id","title","source_agency","release_name","units","frequency","latest_print","surprise","next_release_date","recent","revisions"],"properties":{"title":{"type":"string"},"units":{"type":"string"},"recent":{"type":"array","items":{"type":"object","required":["obs_date","value"],"properties":{"value":{"type":"number"},"obs_date":{"type":"string"}},"additionalProperties":false}},"series":{"type":"string"},"fred_id":{"type":"string"},"surprise":{"anyOf":[{"type":"object","required":["actual","expected","surprise","expectation_source","expectation_detail"],"properties":{"actual":{"type":"number"},"expected":{"type":"number"},"surprise":{"type":"number"},"comparable_market":{"type":"object","required":["slug","market_p","question"],"properties":{"slug":{"type":"string"},"market_p":{"type":"number"},"question":{"type":"string"}},"additionalProperties":false},"expectation_detail":{"type":"string"},"expectation_source":{"enum":["market-implied","trend-model"],"type":"string"}},"additionalProperties":false},{"type":"null"}]},"frequency":{"type":"string"},"revisions":{"type":"array","items":{"type":"object","required":["obs_date","first_value","latest_value"],"properties":{"obs_date":{"type":"string"},"first_value":{"type":"number"},"latest_value":{"type":"number"}},"additionalProperties":false}},"latest_print":{"type":"object","required":["obs_date","headline","headline_units","headline_basis","first_release_value","latest_value","revised","first_released_on"],"properties":{"revised":{"type":"boolean"},"headline":{"type":"number"},"obs_date":{"type":"string"},"latest_value":{"type":"number"},"headline_basis":{"type":"string"},"headline_units":{"type":"string"},"first_released_on":{"anyOf":[{"type":"string"},{"type":"null"}]},"first_release_value":{"type":"number"}},"additionalProperties":false},"release_name":{"type":"string"},"source_agency":{"type":"string"},"surprise_note":{"type":"string"},"next_release_date":{"anyOf":[{"type":"string"},{"type":"null"}]},"next_release_expectation":{"type":"object","required":["expected","slug","market_p","question"],"properties":{"slug":{"type":"string"},"expected":{"type":"number"},"market_p":{"type":"number"},"question":{"type":"string"}},"additionalProperties":false}},"additionalProperties":false},"meta":{"type":"object"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_smUIXv-xyTX0aUPgSRl80","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the latest print, revision history, surprise vs expectation, next release date, and a 12-observation mini-series for a tracked US economic indicator (BLS/BEA/Fed/Census via FRED/ALFRED).","exampleAgentPrompt":"What's the latest CPI print, how did it compare to market expectations, and when is the next release scheduled? I also want to see the last 12 observations.","exampleUseCases":[{"title":"CPI surprise check after release","prompt":"The CPI just came out — can you pull the latest print, tell me how it compares to what the market was expecting, and show me whether the previous numbers were revised?"},{"title":"Payrolls data for macro briefing","prompt":"I'm putting together a macro briefing — grab the latest non-farm payrolls number, the first-release vs current value to flag any revisions, and the next scheduled release date."},{"title":"Core PCE trend monitoring","prompt":"Pull the core PCE series for me, show the last 12 data points, and tell me what the surprise was relative to the trend model expectation on the most recent print."}],"resultDescription":"A JSON object containing: the series slug and FRED ID, title, source agency, release name, units, and frequency; the latest print with first-release and current values; a surprise object with actual, expected, and surprise magnitude plus the expectation source (market-implied or trend-model) and any matching prediction market details; the next scheduled release date; an array of the 12 most recent observations; and a revisions array showing first vs latest values for recent periods.","failureModes":["Unknown or unsupported series slug returns an error — use GET /v1/econ/calendar to list valid slugs","Series has no recent release data yet (e.g. quarterly series between releases) may return null surprise","Prediction market match not available — expectation_source falls back to trend-model","Payment not completed (x402 protocol) results in 402 response requiring USDC payment","FRED/ALFRED data temporarily unavailable causes upstream fetch failure"],"whenToPreferThis":"Choose this endpoint when you need authoritative, revision-aware US macroeconomic indicator data with built-in surprise calculation — especially when you want to distinguish what was known on release day from later revisions, or when you want a market-implied expectation benchmark rather than a simple consensus estimate. Prefer it over raw FRED queries when you need the surprise, revision history, and next release date bundled in one call. Best for CPI, payrolls, PCE, fed funds rate, and similar major US macro series.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T07:06:36.660Z","isFirstParty":false,"canonicalSlug":"x402-factory-us-economic-series-data-99e1f0cd"}