{"uid":"cap_nJgUFA41LiFFoQyznoSml","slug":"2s-fred-economic-data-api-c9b1e01c","name":"2s FRED Economic Data API","description":"Any series in the Federal Reserve's FRED database (800k+ US & international economic time series). HOW TO USE: if you know the series id, pass seriesId to get the series metadata (title, units, frequency, seasonal adjustment, observation range, last updated) + its most-recent observations (date + value, newest first; optionally bound the range with start/end YYYY-MM-DD and cap with limit). If you DON'T know the id, pass query to full-text search the catalog (returns ids + titles + units + frequency, most-popular first) — then call again with the seriesId you found. Popular ids: UNRATE (unemployment rate), CPIAUCSL (CPI), PCEPI (PCE price index), GDP / GDPC1 (nominal / real GDP), PAYEMS (nonfarm payrolls), FEDFUNDS (fed funds rate), DGS10 / DGS2 (10yr / 2yr Treasury), T10Y2Y (10y-2y spread), MORTGAGE30US (30yr mortgage), SP500, VIXCLS (VIX), DEXUSEU (USD/EUR), DCOILWTICO (WTI oil), HOUST (housing starts), UMCSENT (consumer sentiment), M2SL (M2 money supply). Each series' units and frequency come back in the metadata so you know how to read the values. Free, public-domain for most series (FRED attribution). Distinct from econ.indicator (a small curated headline set) — this is the FULL catalog. Companion endpoints: econ.fred-releases (when reports are published — the data calendar) and econ.fred-vintage (point-in-time / revised values for honest backtesting).","url":"https://2s.io/api/econ/fred?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","queryParams"],"properties":{"type":{"const":"http"},"method":{"const":"GET"},"queryParams":{"properties":{"end":{"type":"string","description":"Latest observation date YYYY-MM-DD (seriesId mode)."},"limit":{"type":"integer","description":"Max observations or search results (1-100, default 12)."},"query":{"type":"string","description":"Full-text search the FRED catalog (alternative to seriesId)."},"start":{"type":"string","description":"Earliest observation date YYYY-MM-DD (seriesId mode)."},"seriesId":{"type":"string","description":"FRED series id, e.g. UNRATE, CPIAUCSL, GDP, DGS10."}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.00144","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.00144/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0036","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0036","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_1-9fJLW8IUEzjbIamSGxK","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0036","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches Federal Reserve FRED economic time-series data (observations, metadata, or catalog search) by series ID or full-text query","exampleAgentPrompt":"Pull the monthly unemployment rate (UNRATE) from FRED going back to January 2020 through the latest available date, up to 60 observations.","exampleUseCases":null,"resultDescription":"Returns an array of matched FRED series objects, each containing the series ID, title, units, frequency, seasonal adjustment method, observation start/end dates, last updated timestamp, and an array of date-value observation pairs. Also includes total count and source attribution (FRED license info).","failureModes":["Invalid or unknown seriesId returns empty items array or error","Neither seriesId nor query provided may return an error or empty result","Dates outside observationStart/observationEnd range return no observations","limit out of range (not 1-100) may cause validation error","FRED upstream outage causes delayed or failed response","Payment failure (insufficient USDC) returns 402 before any data is returned"],"whenToPreferThis":"Use this endpoint when you need authoritative US macroeconomic time-series data from the Federal Reserve (FRED) — unemployment, GDP, CPI, interest rates, money supply, housing, and hundreds of other official series — without needing a FRED API key or signup. Prefer over web scraping or unofficial sources when ground-truth, properly attributed Federal Reserve data is required. Also useful for discovering FRED series by keyword when you don't know the exact series ID.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T00:56:57.775Z","isFirstParty":false,"canonicalSlug":"2s-fred-economic-data-api-c9b1e01c"}