{"uid":"cap_DcY7dV5q1W25zKvIkhNms","slug":"fathom-macroeconomic-data-api-8e68d6d9","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://fathom-opal.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.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__DGXicgJoXPMvE4XDfXib","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 from FRED (816,000+ series) including GDP, inflation, unemployment, and interest rates","exampleAgentPrompt":"Pull the last 20 quarterly US GDP observations from FRED (series GDPC1) sorted from oldest to newest, expressed as percent change from a year ago.","exampleUseCases":[{"title":"Inflation trend analysis for report","prompt":"Get me monthly CPI inflation data (CPIAUCSL) from January 2020 through December 2023, shown as percent change from a year ago — I need to chart how inflation evolved over that period."},{"title":"Current unemployment rate lookup","prompt":"What's the most recent US unemployment rate? Pull the latest 5 observations from FRED's UNRATE series sorted newest first so I can see the current figure and recent trend."},{"title":"Interest rate history for mortgage research","prompt":"Fetch the 30-year fixed mortgage rate data from FRED (series MORTGAGE30US) weekly frequency from 2018 to today — I want to see how rates have changed over the last several years."}],"resultDescription":"Returns a JSON object containing the source identifier, FRED series ID, total observation count, and an array of observation objects each with date and value fields representing the requested economic time series data, filtered and transformed per the specified parameters.","failureModes":["Invalid or nonexistent FRED series ID returns error or empty observations","Date range with no available data returns empty observations array","Invalid units or frequency parameter may cause API error","Network or Vercel hosting downtime may cause 5xx errors","Payment failure via x402 protocol blocks request","Requesting very large date ranges may hit response size limits"],"whenToPreferThis":"Choose this endpoint when you need structured, queryable access to any of FRED's 816,000+ macroeconomic time series — especially when you need specific date ranges, frequency aggregations, or unit transformations (e.g. percent change, log). Prefer this over general web search for reliable, authoritative economic data from the Federal Reserve. Ideal for financial analysis, economic research, dashboard enrichment, or any agent workflow requiring quantitative macro data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:41:03.152Z","isFirstParty":false}