# Heurist Mesh FredMacroAgent - Macro Series History

> Heurist Mesh FredMacroAgent - Macro Series 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 bounded historical data for a single curated FRED macro series, with support for transformed views like year-over-year and quarter-over-quarter annualized calculations.

## Facts

- Endpoint: POST https://mesh.heurist.xyz/x402/agents/FredMacroAgent/macro_series_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-fredmacroagent-macro-series-history-61ac91ad
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Ji7zVW4a7lUEkA__U8IyR

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-fredmacroagent-macro-series-history-61ac91ad -d '<json body>'
```

Example prompt: Pull the historical series for US CPI from January 2015 through December 2024 using a year-over-year transformation so I can see how inflation has trended over the past decade.

## When to prefer this

Choose this endpoint when you need bounded historical data for a specific FRED macro series — especially when you want pre-computed transformations like YoY or qoq_annualized rather than raw values. Prefer this over the macro regime summary endpoint when you need granular time-series data for a single indicator rather than a multi-pillar snapshot.

## Known failure modes

- Invalid or unsupported macro series identifier returns an error
- Date range out of bounds for the requested series returns empty or partial data
- Unsupported transformation type returns an error
- Payment failure ($0.003 USDC) blocks request execution
- Network timeout for large historical ranges

## How this service works

Return bounded history for one curated macro series. Use this for historical trend analysis or transformed views like YoY or qoq_annualized.

## Output

A time-indexed array of data points for the requested macro series within the specified date bounds, optionally transformed into YoY percentage changes or quarter-over-quarter annualized rates. Each observation includes the date and corresponding value.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/heurist-mesh-fredmacroagent-macro-series-history-61ac91ad/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)
