{"uid":"cap_YpZ_WK0vaAJSldTcxnDfx","slug":"fathom-macroeconomic-data-api-fred-powered-d3391dbe","name":"Fathom Macroeconomic Data API (FRED-powered)","description":"Free macroeconomic data API powered by FRED. 816,000+ economic time series. GDP, inflation, unemployment, interest rates, and more.","url":"https://fredfathom.vercel.app/api/observations?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","required":["seriesId"],"properties":{"end":{"type":"string","description":"End date YYYY-MM-DD"},"sort":{"type":"string","description":"Sort order: asc or desc (default: desc)"},"limit":{"type":"string","description":"Max observations (default: 10)"},"start":{"type":"string","description":"Start date YYYY-MM-DD"},"units":{"type":"string","description":"Units transformation (lin, chg, ch1, pch, pca, cch, cca, log)"},"seriesId":{"type":"string","description":"FRED series ID (e.g. GDP, UNRATE, CPIAUCSL)"},"frequency":{"type":"string","description":"Frequency (d, w, bw, m, q, sa, a)"}}},"responseSchema":{"type":"object","required":["source"],"properties":{"count":{"type":"number"},"source":{"type":"string"},"series_id":{"type":"string"},"observations":{"type":"array","items":{"type":"object"}}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.06","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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.06/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.06","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.06","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_o1p6I-Wawo_m3a65KeBxm","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.06","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves historical and current economic time series observations (GDP, inflation, unemployment, interest rates, etc.) from the FRED database by series ID, with optional date range, frequency, and unit transformation filters.","exampleAgentPrompt":"Pull the last 20 quarterly observations of US GDP from FRED — series GDPC1 — sorted from oldest to newest, expressed as percent change from a year ago.","exampleUseCases":[{"title":"Inflation trend research","prompt":"Fetch monthly CPI inflation data (CPIAUCSL) from January 2018 through December 2023, expressed as percent change from a year ago, so I can see how inflation evolved before and after the pandemic."},{"title":"Unemployment rate dashboard","prompt":"Give me the last 24 monthly observations of the US unemployment rate from FRED — series UNRATE — sorted oldest to newest, so I can chart the trend."},{"title":"Interest rate policy analysis","prompt":"Get me 10 years of monthly 10-year Treasury yield data from FRED using series DGS10, from January 2015 to January 2025, in the default linear units."}],"resultDescription":"Returns a JSON object containing the FRED series ID, the data source label, the count of returned observations, and an array of observation objects each containing a date and value. Supports up to 816,000+ FRED economic series with optional frequency aggregation and unit transformations (e.g. percent change, log).","failureModes":["Invalid or unknown FRED series ID returns an error or empty observations array","Date range outside the series coverage window returns zero observations","Invalid units transformation string causes a bad request error","Invalid frequency code results in an error response","Network or upstream FRED API unavailability causes a service error","Malformed date strings (non-YYYY-MM-DD format) may cause parsing errors"],"whenToPreferThis":"Choose this endpoint when you need structured, historical or current macroeconomic time series data backed by the authoritative FRED database (Federal Reserve Bank of St. Louis), especially for US economic indicators like GDP, CPI, unemployment, or interest rates. It is the right choice when you need specific FRED series by ID, flexible date filtering, and unit transformations. Prefer this over generic web search when you need clean, structured numeric data suitable for analysis or charting.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T12:43:47.926Z","isFirstParty":false,"canonicalSlug":"fathom-macroeconomic-data-api-fred-powered-d3391dbe"}