# x402-factory US Economic Series Data

> x402-factory US Economic Series Data is a paid API for AI agents from x402-factory.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-30).

Returns the latest print, revision history, surprise vs expectation, next release date, and a 12-observation mini-series for a tracked US economic indicator (BLS/BEA/Fed/Census via FRED/ALFRED).

## Facts

- Endpoint: GET https://x402-factory.com/v1/econ/:series?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-factory-us-economic-series-data-99e1f0cd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Dao9amb-H-GYJC6_2Jo81

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 x402-factory-us-economic-series-data-99e1f0cd
```

Example prompt: What's the latest CPI print, how did it compare to market expectations, and when is the next release scheduled? I also want to see the last 12 observations.

## When to prefer this

Choose this endpoint when you need authoritative, revision-aware US macroeconomic indicator data with built-in surprise calculation — especially when you want to distinguish what was known on release day from later revisions, or when you want a market-implied expectation benchmark rather than a simple consensus estimate. Prefer it over raw FRED queries when you need the surprise, revision history, and next release date bundled in one call. Best for CPI, payrolls, PCE, fed funds rate, and similar major US macro series.

## Known failure modes

- Unknown or unsupported series slug returns an error — use GET /v1/econ/calendar to list valid slugs
- Series has no recent release data yet (e.g. quarterly series between releases) may return null surprise
- Prediction market match not available — expectation_source falls back to trend-model
- Payment not completed (x402 protocol) results in 402 response requiring USDC payment
- FRED/ALFRED data temporarily unavailable causes upstream fetch failure

## How this service works

US economic series: latest print, revisions, surprise vs labeled expectation — One tracked US economic series (BLS/BEA/Fed/Census via FRED/ALFRED): the latest print with first-release vs latest value (revisions never masquerade as print-day numbers), surprise against a labeled expectation — market-implied when a matching prediction market exists, else a trend model — the next scheduled release…

## Output

A JSON object containing: the series slug and FRED ID, title, source agency, release name, units, and frequency; the latest print with first-release and current values; a surprise object with actual, expected, and surprise magnitude plus the expectation source (market-implied or trend-model) and any matching prediction market details; the next scheduled release date; an array of the 12 most recent observations; and a revisions array showing first vs latest values for recent periods.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object",
     "required": [
      "series"
     ],
     "properties": {
      "series": {
       "type": "string",
       "maxLength": 30,
       "minLength": 2,
       "description": "Series slug, e.g. cpi, core-cpi, payrolls (GET /v1/econ/calendar lists all)"
      }
     }
    },
    "queryParams": {
     "type": "object",
     "properties": {}
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "data",
      "meta"
     ],
     "properties": {
      "data": {
       "type": "object",
       "required": [
        "series",
        "fred_id",
        "title",
        "source_agency",
        "release_name",
        "units",
        "frequency",
        "latest_print",
        "surprise",
        "next_release_date",
        "recent",
        "revisions"
       ],
       "properties": {
        "title": {
         "type": "string"
        },
        "units": {
         "type": "string"
        },
        "recent": {
         "type": "array",
         "items": {
          "type": "object",
          "required": [
           "obs_date",
           "value"
          ],
          "properties": {
           "value": {
            "type": "number"
           },
           "obs_date": {
            "type": "string"
           }
          },
          "additionalProperties": false
         }
        },
        "series": {
         "type": "string"
        },
        "fred_id": {
         "type": "string"
        },
        "surprise": {
         "anyOf": [
          {
           "type": "object",
           "required": [
            "actual",
            "expected",
            "surprise",
            "expectation_source",
            "expectation_detail"
           ],
           "properties": {
            "actual": {
             "type": "number"
            },
            "expected": {
             "type": "number"
            },
            "surprise": {
             "t
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-factory-us-economic-series-data-99e1f0cd/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-factory.com](https://www.zero.xyz/host/x402-factory.com/llms.txt)