# 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/settlement/estimate?amount={usdc} — EUR estimate with fees
- GET /v1/agent/framework — KYA framework docs
- GET /discovery/resources — x402 Bazaar discovery
- POST /mcp — MCP JSON-RPC endpoint
- GET /mcp/sse — MCP over SSE (for Qwen, ModelScope, remote agents)

## Paid Endpoints (x402 or MPP — USDC on Base)
- GET /v1/agent/audit/{address} — $0.005 (full KYA trust audit)
- 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)

## 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.

## 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) | GET /mcp/sse (SSE)
- Website: https://asterpay.io
- Docs: https://asterpay.io/docs
- MPP Spec: https://mpp.dev