{"uid":"cap_PdHScfm1sGTOgt0PQOlCK","slug":"fathom-macroeconomic-data-api-89151fd5","name":"Fathom Macroeconomic Data API","description":"Free macroeconomic data API powered by FRED. 816,000+ economic time series. GDP, inflation, unemployment, interest rates, and more.","url":"https://fsthum.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.4","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.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_eF96vOm_cdu0azRExVUAu","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.4","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches historical observations for any FRED economic time series (GDP, inflation, unemployment, interest rates, etc.) with optional date filtering, frequency, and unit transformations","exampleAgentPrompt":"Can you pull the last 20 quarterly observations of US GDP from FRED, sorted from most recent to oldest, using percent change from a year ago as the unit?","exampleUseCases":[{"title":"Inflation trend research dashboard","prompt":"Get me the last 36 monthly CPI inflation readings (CPIAUCSL) from FRED, starting January 2022 through today, sorted oldest to newest, so I can chart the trend."},{"title":"Unemployment rate briefing","prompt":"What's the US unemployment rate been over the past 12 months? Pull the monthly UNRATE series from FRED with the most recent 12 observations, sorted ascending."},{"title":"Interest rate policy analysis","prompt":"Fetch the Federal Funds Effective Rate (FEDFUNDS) from FRED on a monthly frequency from 2015-01-01 to 2024-12-31, in percent change units, so I can analyze how rates shifted over that decade."}],"resultDescription":"Returns a JSON object containing the FRED series ID, the data source label, a count of returned observations, and an array of observation objects — each typically including a date and the corresponding economic value for that period.","failureModes":["Invalid or unknown FRED series ID returns empty or error response","Date range with no available data returns zero observations","Invalid units or frequency parameter may return an error or fall back to default","Network or upstream FRED API timeout causing failed response","Malformed request body (missing required seriesId) returns validation error"],"whenToPreferThis":"Choose this endpoint when you need historical macroeconomic time series data sourced from FRED — covering GDP, inflation, unemployment, interest rates, and 816,000+ other economic indicators — especially when you want flexible date filtering, frequency aggregation, or unit transformations (e.g. percent change) in a single call. Prefer this over manually scraping FRED or building your own integration when you need rapid, programmatic access to authoritative US and global economic data in an agent workflow.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-27T12:36:01.551Z","isFirstParty":false,"canonicalSlug":"fathom-macroeconomic-data-api-89151fd5"}