# AsterPay Data API

> EUR settlement layer for AI agent payments. USDC/EURC to EUR via SEPA Instant.

## Base URL: https://x402.asterpay.io

## Free Endpoints (no payment required)
- GET /v1/agent/trust-score/{address} — KYA trust score 0-100
- GET /v1/agent/verify/{address} — Agent identity verification
- GET /v1/agent/tier/{address} — Trust tier classification
- GET /v1/agent/audit/{address} — Full KYA audit, inputs and breakdown
- GET /v1/settlement/estimate?amount={usdc} — EUR estimate with fees
- GET /v1/agent/framework — KYA framework docs
- GET /discovery/resources — x402 Bazaar discovery
- POST /mcp — MCP endpoint (JSON-RPC 2.0 / streamable HTTP — canonical)

## Paid Endpoints (x402 or MPP — USDC on Base)
- GET /v1/agent/deep-analysis/{address} — $0.01
- GET /v2/x402/crypto/prices — $0.005
- POST /v2/x402/ai/sentiment — $0.01
- POST /v2/x402/ai/fact-check — $0.01 — Source-bounded fact-check
- POST /v2/x402/ai/fact-check/deep — $0.05 — Deep fact-check (claim decomposition)

## Data Doors (/v1/data/*, official sources, $0-$0.005)
- GET /v1/data — free catalog of every door: price, source, cadence, params, example URL
- GET /v1/data/fx/ecb — $0.002 — ECB euro reference rates, 30 currencies (daily)
- GET /v1/data/fx/pair/{base}/{quote} — $0.002 — FX cross rate from ECB fixings (daily)
- GET /v1/data/energy/oil — $0.005 — Brent and WTI spot price (EIA) (daily)
- GET /v1/data/energy/natgas — $0.005 — Henry Hub natural gas spot (EIA) (daily)
- GET /v1/data/energy/us-grid — $0.005 — US grid demand and generation mix, hourly (EIA) (hourly)
- GET /v1/data/energy/crude-imports — $0.005 — US crude oil imports by origin country, latest month (EIA-814) (monthly)
- GET /v1/data/energy/nuclear-outages — $0.005 — US nuclear reactor outages today (NRC via EIA) (daily)
- GET /v1/data/energy/steo-forecast — $0.005 — EIA 18-month forecast: Brent, WTI, Henry Hub, gasoline, US and world oil (monthly)
- GET /v1/data/energy/us-energy-overview — $0.005 — US total energy: production, consumption, trade and CO2 (Monthly Energy Review) (monthly)
- GET /v1/data/energy/electricity-retail/{state} — $0.005 — US retail electricity price, sales and customers by state and sector (monthly)
- GET /v1/data/macro/us-debt — $0.002 — US national debt to the penny (Treasury) (daily)
- GET /v1/data/macro/inflation/{region} — $0.005 — Consumer price inflation, US (BLS) or EU (Eurostat HICP) (monthly)
- GET /v1/data/macro/rates — $0.005 — Policy rates and US yield curve (Fed, ECB, Treasury) (daily)
- GET /v1/data/macro/recession — $0.005 — US recession signals: Sahm rule and prediction markets (monthly)
- GET /v1/data/macro/bank-failures — $0.002 — US bank failures, year to date (FDIC) (weekly)
- GET /v1/data/stablecoins/supply — $0.005 — Stablecoin supply by issuer, USD and EUR pegged (15m)
- GET /v1/data/stablecoins/peg — $0.005 — Stablecoin peg deviations (5m)
- GET /v1/data/crypto/fear-greed — $0.002 — Crypto Fear and Greed index (daily)
- GET /v1/data/crypto/hacks — $0.005 — DeFi hacks and exploits, last 30 days and YTD (daily)
- GET /v1/data/security/cve-critical — $0.005 — Critical CVEs published in the last 24 hours (NVD) (hourly)
- GET /v1/data/security/kev — $0.002 — CISA Known Exploited Vulnerabilities, latest additions (daily)
- GET /v1/data/security/ransomware — $0.005 — Ransomware victims posted on leak sites (hourly)
- GET /v1/data/company/vat/{vatId} — $0.005 — EU VAT number validation (VIES) (live)
- GET /v1/data/risk/agi — free — AGI arrival forecasts from prediction markets (daily)
- GET /v1/data/risk/ai-extinction — free — AI extinction risk forecasts and the Doomsday Clock (daily)
- GET /v1/data/risk/doomsday-clock — free — Doomsday Clock: seconds to midnight (yearly)
- GET /v1/data/risk/asteroids — $0.001 — Asteroid close approaches next 7 days and Sentry impact risk (daily)
- GET /v1/data/risk/space-weather — $0.001 — Geomagnetic storm level and space weather alerts (NOAA) (15m)
- GET /v1/data/risk/earthquakes — $0.001 — Earthquakes M4.5+ in the last 24 hours (USGS) (5m)
- GET /v1/data/risk/outbreaks — $0.001 — WHO Disease Outbreak News, latest (daily)
- GET /v1/data/risk/climate — $0.001 — Atmospheric CO2 and global temperature anomaly (monthly)
- GET /v1/data/risk/markets — $0.001 — Prediction markets on recession, AI, nuclear, Taiwan, Iran, pandemic (5m)
- GET /v1/data/risk/board — free — World Risk Board: all risk doors in one response (5m)
- Every response carries observed_at (upstream timestamp), cadence and stale; a door whose upstream is down answers 503 before payment, never charge-then-fail

## Payment Protocols (dual support)
- x402: PAYMENT-REQUIRED / PAYMENT-SIGNATURE headers (Coinbase CDP)
- MPP: WWW-Authenticate: Payment / Authorization: Payment headers (Stripe/Tempo open standard)
- Both protocols return HTTP 402 with payment details
- Both accept USDC on Base

## Protocols: x402, x402r (escrow/refund), MPP, AP2, A2A, ERC-8004
## Chains: Base, Polygon, Arbitrum, Optimism, Ethereum (5 EVM chains with native USDC)

## Example (x402)
curl https://x402.asterpay.io/v2/x402/crypto/prices
# Returns 402 with PAYMENT-REQUIRED header + WWW-Authenticate: Payment header
# Pay via x402: npm install @x402/fetch
# Pay via MPP:  npm install mppx

## Example (Free)
curl https://x402.asterpay.io/v1/agent/trust-score/0xYourAddress
curl "https://x402.asterpay.io/v1/settlement/estimate?amount=100"

## Authentication
Free endpoints require no key or token.
Paid endpoints accept either x402 or MPP payment proofs.
No API key exists, none is issued, and no account is needed — every paid call carries its own wallet signature.

## First Call Free
A payer wallet that has never paid AsterPay gets its first sub-$0.02 paid call for $0.
Send a normally signed PAYMENT-SIGNATURE — the authorization is verified but never settled. No opt-in.
Precondition: your wallet must hold at least the endpoint price, because payment libraries refuse to sign an authorization they cannot cover. Nothing is deducted. With a zero balance, use the free endpoints above.

## Integration
- x402 SDK: npm install @x402/fetch | pip install x402
- MPP SDK: npm install mppx | pip install pympp
- MCP: POST /mcp (JSON-RPC 2.0 / streamable HTTP)
- Website: https://asterpay.io
- Docs: https://asterpay.io/docs
- MPP Spec: https://mpp.dev