# x402 Crypto Data APIs

Pay-per-call cryptocurrency market data for AI agents. No API keys, no subscriptions — micropayments in USDC on Base network via the x402 payment protocol.

## Endpoints (all GET, paid via x402 USDC on Base)

- GET /api/crypto/price?coin=bitcoin — $0.01 USDC — Real-time crypto price, 24h change, market cap. Default coin: bitcoin. Accepts any CoinGecko coin ID.
- GET /api/crypto/top?limit=10 — $0.02 USDC — Top N cryptocurrencies ranked by market cap with prices, 24h changes, and volume.
- GET /api/crypto/signals?coin=bitcoin — $0.03 USDC — RSI-based trading signals: BUY, SELL, or HOLD with strength indicator (STRONG, MODERATE, NEUTRAL).
- GET /api/crypto/overview?format=full — $0.05 USDC — Comprehensive market overview: top 5 coins, BTC/ETH data, and market sentiment (BULLISH/BEARISH/NEUTRAL).
- GET /health — FREE — Service health check, wallet address, x402 version.

## Payment Details
- Protocol: x402 v2
- Currency: USDC (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913)
- Network: Base (EIP-155:8453)
- Wallet: 0xAE58B7f8102BdBF7478faB7eF58C5FE4d2d2042E

## Discovery
- OpenAPI: https://x402-crypto-apis.onrender.com/openapi.json
- Agent Card: https://x402-crypto-apis.onrender.com/.well-known/agent.json
- x402 Discovery: https://x402-crypto-apis.onrender.com/.well-known/x402.json

## How to Pay
1. Call any paid endpoint → receive 402 Payment Required with payment details
2. Send USDC micropayment on Base network to the wallet
3. Include payment proof in PAYMENT-SIGNATURE header
4. Receive data instantly

## Source
GitHub: https://github.com/ayoub55555555/x402-crypto-apis
Data Source: CoinGecko API