# Fathom Macroeconomic Data API — Vintage Dates

> Fathom Macroeconomic Data API — Vintage Dates is a paid API for AI agents from fathoms.vercel.app, paid per call via x402, $0.06/call, status unknown (last checked 2026-09-14).

Retrieves vintage date history for a FRED economic time series, showing when data was published or revised over time

## Facts

- Endpoint: POST https://fathoms.vercel.app/api/vintage
- Price: $0.06/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/fathom-macroeconomic-data-api-vintage-dates-00b82cc4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_2tJ0kJPyJltvNMjEsFL6S

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 fathom-macroeconomic-data-api-vintage-dates-00b82cc4 -d '<json body>'
```

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

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

Free macroeconomic data API powered by FRED. 816,000+ economic time series. GDP, inflation, unemployment, interest rates, and more.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "seriesId"
 ],
 "properties": {
  "limit": {
   "type": "string",
   "description": "Max results (default: 10)"
  },
  "seriesId": {
   "type": "string",
   "description": "FRED series ID"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "source"
 ],
 "properties": {
  "source": {
   "type": "string"
  },
  "series_id": {
   "type": "string"
  },
  "vintage_dates": {
   "type": "array",
   "items": {
    "type": "object"
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/fathom-macroeconomic-data-api-vintage-dates-00b82cc4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from fathoms.vercel.app](https://www.zero.xyz/host/fathoms.vercel.app/llms.txt)