{"uid":"cap_soEokxOqNSpW_FE-u8KuX","slug":"fathom-macroeconomic-data-api-releases-endpoint-b6126318","name":"Fathom Macroeconomic Data API — Releases Endpoint","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/releases","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"dates":{"type":"boolean","description":"If true, return dates only"},"limit":{"type":"string","description":"Max results (default: 20)"}}},"responseSchema":{"type":"object","required":["source"],"properties":{"source":{"type":"string"},"releases":{"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_9_kRYeUceAkdF04eDyD-8","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":"Returns a list of economic data releases from FRED, optionally filtered to dates only and limited in count","exampleAgentPrompt":"Can you fetch me the list of macroeconomic data releases available through FRED — just pull the first 10 and include the dates?","exampleUseCases":[{"title":"Browse FRED release catalog","prompt":"Show me up to 20 economic data releases available in the FRED database so I can see what macroeconomic indicators are published."},{"title":"Get release dates for scheduling","prompt":"Can you get me just the dates of the most recent economic data releases from FRED — I want to see when things like GDP and inflation data were last published?"},{"title":"Audit available macro data sources","prompt":"Pull the full list of macroeconomic data releases from FRED and tell me what the data source is — I'm trying to understand what series are available before I dig into specific indicators."}],"resultDescription":"Returns a JSON object with a 'source' string identifying the data provider and a 'releases' array of release objects, each describing a named group of economic time series (e.g. GDP, CPI, unemployment). When 'dates' is true, only date information is returned per release.","failureModes":["Invalid 'limit' value (non-numeric string) may cause unexpected truncation or error","Network timeout if FRED upstream is slow","Empty releases array if FRED returns no results for the requested configuration","Missing 'releases' key if source system is unavailable"],"whenToPreferThis":"Use this endpoint when you need to enumerate or browse the top-level catalog of economic data releases from FRED — especially when you want to discover what macro data series are available before querying specific series. Prefer this over searching individual series endpoints when you need a structural overview of release groups (e.g. which release contains CPI, which contains unemployment data).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:34:33.104Z","isFirstParty":false}