# ECB Macro/Economic Snapshot

> ECB Macro/Economic Snapshot is a paid API for AI agents from x402-endpoints.onrender.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Returns a structured, signed snapshot of key euro-area macroeconomic indicators sourced directly from the ECB (inflation, rates, FX, unemployment) for a given reference area.

## Facts

- Endpoint: GET https://x402-endpoints.onrender.com/macro/snapshot
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ecb-macro-economic-snapshot-82bcdc3f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_mItGfHKFwFQL25-79BDR9

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 ecb-macro-economic-snapshot-82bcdc3f
```

Example prompt: Pull me the latest euro area macro snapshot — I need HICP inflation, the ECB deposit facility rate, unemployment, and the EUR/USD FX rate for the U2 region, all from official ECB sources.

## When to prefer this

Choose this endpoint when you need official, verifiable ECB macroeconomic data — especially inflation (HICP), key policy rates, unemployment, or EUR FX reference rates — sourced directly from the ECB SDMX portal with cryptographic attestation. Prefer it over web scraping or LLM-generated figures when auditability, data provenance, and a signed receipt matter (e.g. compliance, due diligence, financial reporting). Ideal for euro-area or EU country-level queries; less appropriate for US, Asian, or non-ECB economic data.

## Known failure modes

- Unsupported area code returns an error or empty result
- Invalid or misspelled indicator name may be silently skipped, reducing resolved count
- Some indicators may be unavailable for non-euro-area country codes, returning a PARTIAL verdict
- ECB data portal downtime can cause fetch failures or stale data
- Payment failure (insufficient USDC balance or x402 protocol error) results in 402 response with no data

## How this service works

Macro economic snapshot API — dated Eurozone economic indicators for trading/research agents: euro-area inflation (HICP / CPI), ECB policy interest rates (deposit, refi), unemployment and EUR FX from the official European Central Bank data portal — each indicator with value, as_of date, next_release cadence and a signed dated snapshot receipt for reproducible backtests. The interest-rate, inflation and currency context an agent needs before trading.

## Output

A machine-readable JSON object containing requested macroeconomic indicators (each with value, unit, as_of date, source series key, and next release schedule), a verdict (COMPLETE or PARTIAL), confidence score, data freshness metadata, and a cryptographically signed snapshot receipt (ed25519) attesting to the values hash and snapshot timestamp. Includes a disclaimer that this is official ECB reference data, not live market quotes.

## 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",
     "required": [],
     "properties": {
      "area": {
       "type": "string",
       "description": "HICP reference area: 'U2' (euro area, default) or a country code e.g. 'FR','DE'"
      },
      "indicators": {
       "type": "string",
       "description": "Comma-separated: inflation_hicp, core_inflation, unemployment, deposit_facility_rate, main_refi_rate, marginal_lending_rate, fx_usd, fx_gbp, fx_jpy, fx_chf"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "error": null,
  "query": {
   "area": "U2",
   "indicators": [
    "inflation_hicp",
    "deposit_facility_rate",
    "unemployment",
    "fx_usd"
   ]
  },
  "cached": false,
  "reasons": [
   {
    "code": "INDICATORS_RETURNED",
    "label": "4/4 indicators resolved from official ECB series",
    "weight": -0.5
   }
  ],
  "verdict": "COMPLETE",
  "timestamp": "2026-06-29T12:00:00Z",
  "confidence": 1,
  "disclaimer": "Official ECB reference data (informational). Reference rates/values, not live market quotes. Not investment advice.",
  "indicators": {
   "inflation_hicp": {
    "unit": "% YoY",
    "as_of": "2026-05",
    "label": "HICP headline inflation (annual rate of change)",
    "value": 2,
    "source": "European Central Bank — Data Portal SDMX 2.1 (data-api.ecb.europa.eu)",
    "status": "ok",
    "series_key": "ICP/M.U2.N.000000.4.ANR",
    "next_release": {
     "note": "Exact date per the ECB official calendar.",
     "cadence": "monthly (flash ~end of reference month, final ~mid next month)",
     "is_estimated": true,
     "authoritative_calendar": "https://www.ecb.europa.eu/press/calendars/statscal/html/index.en.html"
    }
   },
   "deposit_facility_rate": {
    "unit": "% p.a.",
    "as_of": "2026-06-26",
    "label": "ECB deposit facility rate (DFR)",
    "value": 2,
    "source": "European Central Bank — Data Portal SDMX 2.1 (data-api.ecb.europa.eu)",
    "status": "ok",
    "series_key": "FM/D.U2.EUR.4F.KR.DFR.LEV",
    "next_release": {
     "note": "Exact date per the ECB official calendar.",
     "cadence": "per ECB Governing Council monetary-policy meeting",
     "is_estimated": true,
     "authoritative_calendar": "https://www.ecb.europa.eu/press/calendars/mgcgc/html/index.en.html"
    }
   }
  },
  "data_freshness": {
   "as_of": "2026-05",
   "sources": [
    "European Central Bank — Data Portal SDMX 2.1 (data-api.ecb.europa.eu)"
   ],
   "resolved": 4,
   "requested": 4,
   "age_seconds": 2592000,
   "values_hash": "9f1c2a3b4d5e6f70",
   "retrieved_at": "2026-06-29T12:00:00Z",
   "deterministic": true
  },
  "signed_snapshot_receipt": {
   "claims": {
    "area": "U2",
    "kind": "macro_snapshot",
    "verdict": "COMPLETE",
    "snapshot_at": "2026-06-29T12:00:00Z",
    "values_hash": "9f1c2a3b4d5e6f70"
   },
   "algorithm": "ed25519",
   "available": true,
   "signature": "<hex>",
   "public_key": "5b77f2e95c3eee40403453e942834b703383e15fca50d11fdd28633ca5dd9f9d"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ecb-macro-economic-snapshot-82bcdc3f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-endpoints.onrender.com](https://www.zero.xyz/host/x402-endpoints.onrender.com/llms.txt)