{"uid":"cap_2tJ0kJPyJltvNMjEsFL6S","slug":"fathom-macroeconomic-data-api-vintage-dates-00b82cc4","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://fathoms.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_Ctz3mscvxw3MJ_DjuQVZ1","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 vintage date history for a FRED economic time series, showing when data was published or revised over time","exampleAgentPrompt":"Pull the vintage dates for the FRED series UNRATE — I want to see up to 20 entries showing when the unemployment rate data was published or revised.","exampleUseCases":[{"title":"Track GDP revision history","prompt":"Get the vintage dates for the FRED series GDP — show me the last 15 dates so I can see when quarterly GDP data has been revised."},{"title":"Monitor CPI publication timeline","prompt":"Fetch the publication and revision history for the FRED series CPIAUCSL — give me 10 vintage dates so I can track when inflation data was officially released."},{"title":"Research Fed funds rate data revisions","prompt":"Look up vintage dates for FEDFUNDS in FRED — I need to know when the federal funds rate time series data was last revised, up to 20 results."}],"resultDescription":"Returns a JSON object containing the FRED series ID, the data source label, and an array of vintage date objects representing each point in time when the series data was published or revised. Each item in the vintage_dates array reflects a distinct data release or revision event.","failureModes":["Invalid or unknown FRED series ID returns an error or empty result","Malformed seriesId causes request rejection","Limit parameter set to a non-numeric string may be ignored or cause error","FRED upstream service unavailability may result in timeout or 5xx error","Request without required seriesId field returns validation error"],"whenToPreferThis":"Choose this endpoint when you need to understand the revision history or publication timeline of a specific FRED economic series — particularly useful for data quality analysis, backtesting economic models with real-time data vintages, or auditing when official statistics were released or revised. Prefer this over a general series data endpoint when your goal is metadata about data provenance rather than the data values themselves.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:43:18.106Z","isFirstParty":false}