{"uid":"cap_0XFeMU9TeAH1EVFH2KUA0","slug":"fathom-macroeconomic-data-api-observations-d3f93d1a","name":"Fathom Macroeconomic Data API — Observations","description":"Free macroeconomic data API powered by FRED. 816,000+ economic time series. GDP, inflation, unemployment, interest rates, and more.","url":"https://fredthom.vercel.app/api/observations","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.4","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.4/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.4","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.4","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_oHh3wivVK2vVroxCil2Ot","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.4","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches historical economic time series observations from FRED (Federal Reserve Economic Data) for any of 816,000+ macroeconomic indicators","exampleAgentPrompt":"Pull the last 20 quarterly observations of US GDP (FRED series GDP) in percent change from a year ago format, sorted ascending from 2019-01-01 to today.","exampleUseCases":null,"resultDescription":"Returns a JSON object containing the FRED series ID, the data source label, a count of observations returned, and an array of observation objects — each with a date and value — filtered and transformed according to the requested parameters.","failureModes":["Invalid or unknown FRED series ID returns an error or empty observations array","Date range outside available data returns zero observations","Invalid units or frequency parameter may return an error or fallback to default","Rate limit or payment failure (402) blocks the request","Network timeout on Vercel serverless function under heavy load"],"whenToPreferThis":"Choose this endpoint when you need programmatic access to any of FRED's 816,000+ macroeconomic time series — GDP, unemployment, inflation, interest rates, money supply, trade data, etc. — with optional date filtering, frequency aggregation, and unit transformations (e.g. percent change). Prefer this over direct FRED API access when using x402 micropayment-based billing is acceptable and you want a simple POST interface without managing FRED API keys.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:49:26.322Z","isFirstParty":false}