# 2s FRED Vintage Data API

> 2s FRED Vintage Data API is a paid API for AI agents from 2s.io, paid per call via x402, $0.0042/call, status unknown (last checked 2026-09-14).

Retrieves historical FRED economic time-series data as it was known on a specific vintage date, enabling point-in-time economic analysis

## Facts

- Endpoint: GET https://2s.io/api/econ/fred-vintage
- Price: $0.0042/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/2s-fred-vintage-data-api-5c6d04de
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_pa2o3oUz0v92hE_FAhWre

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability 2s-fred-vintage-data-api-5c6d04de
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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).

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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."
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/2s-fred-vintage-data-api-5c6d04de/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 2s.io](https://www.zero.xyz/host/2s.io/llms.txt)