{"uid":"cap_hhGVLFZDZhDHZqUOgRYjm","slug":"fathom-macroeconomic-data-api-observations-69f082d1","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://fathoms.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_AeUyoOiBSkHuWojh7eBNs","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":"Fetches time-series observations for any FRED economic indicator (GDP, inflation, unemployment, interest rates, etc.) with flexible date ranges, frequency, and unit transformations","exampleAgentPrompt":"Pull the monthly US CPI inflation data (CPIAUCSL) from FRED for January 2020 through December 2023, sorted oldest to newest, and give me up to 50 observations in percent change from a year ago.","exampleUseCases":[{"title":"Inflation trend analysis for report","prompt":"Get me the last 24 monthly observations of US CPI inflation (CPIAUCSL) sorted from oldest to newest so I can chart the inflation trend over the past two years."},{"title":"Unemployment rate dashboard widget","prompt":"Fetch the most recent 12 monthly observations of the US unemployment rate (UNRATE) from FRED so I can display them on my economics dashboard."},{"title":"GDP growth comparison across periods","prompt":"Pull quarterly US real GDP data (GDP) from FRED from 2010-01-01 to 2024-01-01 in percent change from a year ago so I can compare growth rates across the last decade."}],"resultDescription":"Returns a JSON object containing the FRED series ID, data source label, total observation count, and an array of observation objects each with a date and value. The array is ordered by the requested sort direction and capped at the requested limit.","failureModes":["Invalid or unknown FRED series ID returns an error or empty observations array","Malformed date strings cause bad request errors","Requesting too many observations may result in truncated or slow responses","Invalid units or frequency codes may be rejected or silently ignored","Network or Vercel deployment timeouts if FRED upstream is slow"],"whenToPreferThis":"Choose this endpoint when you need programmatic access to any of FRED's 816,000+ macroeconomic time series — especially GDP, CPI, unemployment, interest rates, and monetary aggregates — with control over date range, frequency aggregation, and unit transformation. Prefer this over direct FRED API access when you want a simpler POST interface with x402 micropayment support and no FRED API key management.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:49:07.285Z","isFirstParty":false}