# US Macro Snapshot (GDP, CPI, Unemployment, Trade)

> US Macro Snapshot (GDP, CPI, Unemployment, Trade) is a paid API for AI agents from agentdatum.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Returns a snapshot of key US macroeconomic indicators — GDP, GDP growth, CPI inflation, unemployment rate, population, and trade balance — sourced from World Bank open data.

## Facts

- Endpoint: GET https://agentdatum.com/api/v1/us/macro
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/us-macro-snapshot-gdp-cpi-unemployment-trade-a9d18cce
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_hkUANScQtYlTkVDD7v50M

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 us-macro-snapshot-gdp-cpi-unemployment-trade-a9d18cce
```

Example prompt: Pull the latest US macro snapshot — I want to see GDP, GDP growth, CPI inflation, unemployment rate, population, and trade balance, all from World Bank data.

## When to prefer this

Choose this endpoint when you need a broad, reliable macro snapshot of the US economy in a single call — covering GDP, inflation, unemployment, population, and trade balance — without assembling multiple data sources. Ideal for agents building economic summaries, briefings, investment context, or dashboards. Prefer the US Bundle endpoint if you also need industry or detailed trade/demographics data. Use this standalone endpoint when only core macro indicators are needed and cost efficiency per call matters.

## Known failure modes

- World Bank data source temporarily unavailable — service may return stale or missing values
- Payment not processed (x402 protocol failure) — endpoint returns 402 Payment Required
- Rate limiting or quota exceeded — endpoint returns error response
- Requested data point not yet updated in World Bank dataset — may return previous year's figure

## How this service works

🇺🇸 US MACRO SNAPSHOT — GDP, GDP growth, CPI inflation, unemployment rate, population, trade balance. Sourced from World Bank open data. The world's largest economy at your fingertips. 💎【付款后立得】实时结构化JSON，即插即用——无需注册，USDC一键支付即取数据。

## Output

Returns a structured set of US macroeconomic indicators including GDP (absolute value), GDP growth rate, CPI-based inflation rate, unemployment rate, total population, and trade balance — all sourced from World Bank open data. Values reflect the most recently available World Bank figures.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {}
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "cpi_yoy_pct": 2.9,
  "gdp_usd_trillions": 29.4,
  "trade_balance_usd": -918,
  "population_millions": 335,
  "unemployment_rate_pct": 3.9
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/us-macro-snapshot-gdp-cpi-unemployment-trade-a9d18cce/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentdatum.com](https://www.zero.xyz/host/agentdatum.com/llms.txt)
