{"uid":"cap_nFgQRQLmq6cW4OTninM8K","slug":"fathom-macroeconomic-data-api-vintage-dates-b15fb225","name":"Fathom Macroeconomic Data API — Vintage Dates","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/vintage","method":"POST","headers":{},"bodySchema":{"type":"object","required":["seriesId"],"properties":{"limit":{"type":"string","description":"Max results (default: 10)"},"seriesId":{"type":"string","description":"FRED series ID"}}},"responseSchema":{"type":"object","required":["source"],"properties":{"source":{"type":"string"},"series_id":{"type":"string"},"vintage_dates":{"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_HIEPP1j9ZRbvW0-eRsR4M","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 the list of vintage dates (data release timestamps) for a given FRED economic time series, showing when historical data was revised or published","exampleAgentPrompt":"Can you pull the vintage dates for the FRED series GDPC1 — I want to see up to 20 entries showing when that GDP data was published or revised over time.","exampleUseCases":[{"title":"GDP revision history for research","prompt":"I'm writing an economics paper and need to know all the dates when real GDP data (FRED series GDPC1) was revised — can you fetch the vintage dates, up to 50 entries?"},{"title":"Inflation data release tracking","prompt":"Pull the vintage dates for the CPIAUCSL series from FRED so I can see exactly when CPI inflation data was published or updated historically — give me the last 15."},{"title":"Unemployment data revision audit","prompt":"I need to audit when the UNRATE unemployment series was revised over time — can you get me the vintage dates for that FRED series, showing 25 results?"}],"resultDescription":"Returns a JSON object containing the data source label, the FRED series ID, and an array of vintage date objects — each representing a date when the time series data was released, revised, or updated by the original data provider.","failureModes":["Invalid or unknown FRED series ID returns an error or empty result","Limit parameter ignored or causing unexpected truncation if malformed","Network timeout from the Vercel serverless deployment under cold-start conditions","FRED upstream API outage causing data unavailability","Payment failure via x402 protocol blocking the request"],"whenToPreferThis":"Choose this endpoint when you specifically need to know WHEN a FRED economic time series was published or revised — i.e., its vintage dates — rather than the actual data values. Ideal for macroeconomic research requiring data revision history, real-time data analysis, or understanding how estimates were updated over time. Prefer this over general FRED wrappers if you need a pay-per-call, no-subscription model with USDC micropayments via x402.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:32:47.995Z","isFirstParty":false}