{"uid":"cap_pa2o3oUz0v92hE_FAhWre","slug":"2s-fred-vintage-data-api-5c6d04de","name":"2s FRED Vintage Data API","description":"Point-in-time (vintage) economic data from FRED's ALFRED archive — what an economic figure was AS FIRST REPORTED / as known on a past date, before later revisions. Give a seriesId (e.g. GDP, GDPC1, PAYEMS, INDPRO) and an asOf date to get the observations exactly as they stood on that date; omit asOf to get the current (latest-revised) values. Also returns the series' vintage (revision) dates — every date the series was revised. Free, public-domain (FRED). Critical for honest backtesting and macro research: it eliminates look-ahead bias (e.g. GDP for 2020Q1 was first reported far lower than today's revised figure). No LLM and no real-time API gives this — it's the archived state of the data through time. Pair with econ.fred (current series) and econ.fred-releases (release calendar).","url":"https://2s.io/api/econ/fred-vintage","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","queryParams"],"properties":{"type":{"const":"http"},"method":{"const":"GET"},"queryParams":{"required":["seriesId"],"properties":{"end":{"type":"string","description":"Latest observation date YYYY-MM-DD."},"asOf":{"type":"string","description":"Vintage date YYYY-MM-DD (values as known then). Omit for current."},"limit":{"type":"integer","description":"Max observations (1-100, default 12)."},"start":{"type":"string","description":"Earliest observation date YYYY-MM-DD."},"seriesId":{"type":"string","description":"FRED series id, e.g. GDP, GDPC1, PAYEMS."}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.0042","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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.0042/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0042","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0042","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_liOyEcPefMOTgELOnwvGG","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0042","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves historical FRED economic time-series data as it was known on a specific vintage date, enabling point-in-time economic analysis","exampleAgentPrompt":"Pull the FRED series GDPC1 (real GDP) as it was known as of 2022-01-01, starting from 2018-01-01 through 2021-12-31, returning up to 20 observations.","exampleUseCases":null,"resultDescription":"Returns an array of economic time-series observations for the requested FRED series, reflecting data values as they were known on the specified vintage date — enabling point-in-time analysis unaffected by subsequent data revisions. Each observation includes the date and the reported value.","failureModes":["Invalid FRED series ID returns an error — use standard FRED identifiers like GDP, GDPC1, PAYEMS","Date format errors if not provided as YYYY-MM-DD","Vintage date before the series start returns empty or error","Limit out of range (must be 1-100) returns a validation error","Network or payment failure returns 402 or 5xx"],"whenToPreferThis":"Use this endpoint when you need point-in-time (vintage) economic data from FRED — i.e., data as it was reported on a specific date before subsequent revisions. Ideal for backtesting economic models, reproducing historical analyses, or any scenario where data revision history matters. Prefer over live FRED queries when reproducibility and historical accuracy are critical.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T07:07:22.173Z","isFirstParty":false}