# Heurist Mesh: FRED Macro Vintage History

> Heurist Mesh: FRED Macro Vintage History is a paid API for AI agents from mesh.heurist.xyz, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-13).

Returns point-in-time-safe historical data for a single FRED macroeconomic series using ALFRED vintage dates, suitable for backtests and retrospective analysis.

## Facts

- Endpoint: POST https://mesh.heurist.xyz/x402/agents/FredMacroAgent/macro_vintage_history
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/heurist-mesh-fred-macro-vintage-history-6c065dd2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_TYjGc9pX_BK9CBMdieIkD

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 heurist-mesh-fred-macro-vintage-history-6c065dd2 -d '<json body>'
```

Example prompt: Pull the point-in-time vintage history for the FRED series UNRATE (U.S. unemployment rate) as of realtime date 2020-03-01 — I need the unrevised values so I can backtest a trading model without look-ahead bias.

## When to prefer this

Choose this endpoint when you need macroeconomic data exactly as it was known at a specific historical moment — critical for backtesting trading strategies, building factor models, or conducting retrospective policy analysis where using revised data would introduce look-ahead bias. Prefer this over standard FRED endpoints whenever historical accuracy at a point in time matters more than the most current revised values.

## Known failure modes

- Invalid or unknown FRED series ID returns an error or empty result
- Realtime date outside available ALFRED vintage range returns no data
- Malformed date format causes a request validation error
- Series with no revisions history may return identical data to current FRED
- Network timeout or upstream ALFRED API unavailability causes 5xx error

## How this service works

Return point-in-time-safe history for one curated series using ALFRED realtime dates. Use this for backtests or retrospective questions where revised history would be misleading.

## Output

A time series of historical values for the specified FRED macroeconomic series as they existed at a given realtime (vintage) date, including original release figures without subsequent revisions, enabling point-in-time-safe analysis and backtesting.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/heurist-mesh-fred-macro-vintage-history-6c065dd2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mesh.heurist.xyz](https://www.zero.xyz/host/mesh.heurist.xyz/llms.txt)