# x402stock FRED Economic Series Lookup

> x402stock FRED Economic Series Lookup is a paid API for AI agents from x402stock.xyz, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-08).

Fetches the latest value, prior value, year-over-year change, and historical data for any FRED (Federal Reserve Economic Data) economic series by series ID

## Facts

- Endpoint: GET https://x402stock.xyz/api/v1/fred/%7Bseries%7D
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-08
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402stock-fred-economic-series-lookup-1887bfb6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_qMK-p2Mi1O9Te-1-vpzo-

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 x402stock-fred-economic-series-lookup-1887bfb6
```

Example prompt: What's the latest reading on the VIX — pull the FRED series VIXCLS and show me today's value, how it changed from yesterday, and the year-over-year percent change.

## When to prefer this

Use this endpoint when you need structured, pre-processed economic indicator data from FRED with computed change metrics (absolute, percent, YoY) in a single call — ideal for AI agents that need clean JSON without parsing raw FRED XML/JSON themselves. Prefer over direct FRED API access when you want pay-per-call pricing with no API key management, and when you need VIX, CPI, unemployment, GDP, Fed funds rate, or similar macro series with delta computations already done.

## Known failure modes

- Invalid or unknown series ID returns an error or empty response
- Series exists but has no recent data (discontinued series)
- Payment failure via x402/USDC prevents request from completing
- Rate or network timeout for slow FRED data fetches
- Malformed series ID path parameter causes 400-style error

## How this service works

Pay-per-call market and economic data API for AI agents: US stocks, ETFs and options, forex, crypto and on-chain perps, energy commodities, US and global macro (Fed, CPI, jobs, GDP, Treasury, World Bank), SEC filings, congressional trades, and market sentiment. No API keys, no accounts. Pay per request in USDC via x402 on Base.

## Output

Returns a JSON object with the FRED series title, unit, frequency, source, latest date/value, prior date/value, absolute change, percent change, year-over-year percent change, an as-of timestamp, and a history array of recent data points.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "unit": "index",
  "as_of": "2026-06-04T00:00:00.000Z",
  "prior": {
   "date": "2026-06-03",
   "value": 15.9
  },
  "title": "CBOE Volatility Index (VIX)",
  "change": -0.5,
  "latest": {
   "date": "2026-06-04",
   "value": 15.4
  },
  "source": "fred",
  "history": [
   {
    "date": "2026-06-04",
    "value": 15.4
   }
  ],
  "frequency": "daily",
  "series_id": "VIXCLS",
  "yoy_percent": -12.5,
  "change_percent": -3.14
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402stock-fred-economic-series-lookup-1887bfb6/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402stock.xyz](https://www.zero.xyz/host/x402stock.xyz/llms.txt)