# FRED Macro Signal Series Lookup

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

Returns the latest value, prior, change, year-over-year, and recent history for a curated set of key Federal Reserve (FRED) macroeconomic market-signal series using a simple slug.

## Facts

- Endpoint: GET https://agents.x402stock.xyz/api/v1/fred/{series}
- Price: $0.01/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-09-11
- Activations on Zero: 0
- Provider: agents.x402stock.xyz
- Website: https://agents.x402stock.xyz
- Canonical page: https://www.zero.xyz/c/agents-x402stock-xyz-fred-macro-signal-series-lookup-6f261365
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_M-JgqHfiiVco11op-onGf

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 agents-x402stock-xyz-fred-macro-signal-series-lookup-6f261365
```

Example prompt: What's the current VIX level from FRED — give me the latest value, how it compares to the prior reading, and the year-over-year change?

## When to prefer this

Use this endpoint when you need quick, no-configuration access to one of 12 pre-curated FRED macro market-signal series (VIX, yield curves, credit spreads, breakeven inflation, real yields, jobless claims, consumer sentiment, mortgage rates, financial conditions, recession probability) without needing a FRED API key or knowing the underlying series ID. It is especially valuable for agents building macro dashboards, risk monitors, or economic summaries where you want latest + prior + YoY context in a single call. Prefer alternatives if you need arbitrary FRED series beyond the 12 supported slugs or require raw FRED API access.

## Known failure modes

- Invalid or unsupported series slug returns an error — only the 12 documented slugs are accepted
- Payment failure via x402 results in a 402 response with no data
- Stale or missing FRED data may return nulls for latest, prior, change, or yoy_percent fields
- Network or upstream FRED API outage may cause 5xx errors

## How this service works

Pull a key market-signal macro series from the Federal Reserve (FRED) by slug: vix, yield-curve-10y-2y, yield-curve-10y-3m, high-yield-spread, ig-spread, breakeven-10y, real-yield-10y, jobless-claims, consumer-sentiment, mortgage-30y, financial-conditions, recession-probability. Each returns the latest value, prior, change, year-over-year, and recent history. No ticker needed. From x402stock

## Output

A JSON object with the FRED source label, as-of date, series ID, full title, unit, and frequency, plus the latest {date, value} pair, the prior {date, value} pair, the absolute change, change percent, year-over-year percent change, and an array of recent historical {date, value} data points.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "series"
 ],
 "properties": {
  "series": {
   "type": "string",
   "description": "FRED series ID, e.g. DGS10 (10-year Treasury) or VIXCLS."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "source",
  "as_of",
  "series_id",
  "title",
  "unit",
  "frequency",
  "latest",
  "prior",
  "change",
  "change_percent",
  "yoy_percent",
  "history"
 ],
 "properties": {
  "unit": {
   "type": "string"
  },
  "as_of": {
   "type": "string"
  },
  "prior": {
   "anyOf": [
    {
     "type": "object",
     "required": [
      "date",
      "value"
     ],
     "properties": {
      "date": {
       "type": "string"
      },
      "value": {
       "type": "number"
      }
     },
     "additionalProperties": false
    },
    {
     "type": "null"
    }
   ]
  },
  "title": {
   "type": "string"
  },
  "change": {
   "anyOf": [
    {
     "type": "number"
    },
    {
     "type": "null"
    }
   ]
  },
  "latest": {
   "anyOf": [
    {
     "type": "object",
     "required": [
      "date",
      "value"
     ],
     "properties": {
      "date": {
       "type": "string"
      },
      "value": {
       "type": "number"
      }
     },
     "additionalProperties": false
    },
    {
     "type": "null"
    }
   ]
  },
  "source": {
   "type": "string",
   "const": "fred"
  },
  "history": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "date",
     "value"
    ],
    "properties": {
     "date": {
      "type": "string"
     },
     "value": {
      "type": "number"
     }
    },
    "additionalProperties": false
   }
  },
  "frequency": {
   "type": "string"
  },
  "series_id": {
   "type": "string"
  },
  "yoy_percent": {
   "anyOf": [
    {
     "type": "number"
    },
    {
     "type": "null"
    }
   ]
  },
  "change_percent": {
   "anyOf": [
    {
     "type": "number"
    },
    {
     "type": "null"
    }
   ]
  }
 },
 "additionalProperties": false
}
```

## More

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