# EruditePay Blockchain Intelligence API — Full Reference

> Pay-per-call blockchain analytics for AI agents and developers. 352 endpoints across Base, Tron, and cross-chain. Payment via x402 protocol using USDC (Base) or USDT (Tron). No API keys required — pay with crypto, get data instantly.

## Quick Start for AI Agents

1. Call any endpoint without payment — receive HTTP 402 with payment details
2. Parse the 402 body: { paymentRequirements: { payTo, maxAmountRequired, asset, network } }
3. Sign and submit payment header X-Payment
4. Re-call the endpoint with X-Payment header — receive data

## Discovery Endpoints (Free, No Payment Required)

- GET /.well-known/x402 — Full endpoint catalog with pricing (JSON)
- GET /.well-known/agent-card.json — A2A agent card (protocolVersion 0.3.0)
- GET /.well-known/mcp.json — MCP server descriptor
- GET /.well-known/acp.json — ACP manifest
- GET /.well-known/ap2.json — AP2 manifest
- GET /.well-known/bazaar.json — Coinbase Bazaar registration
- GET /openapi.json — OpenAPI 3.1.0 spec (352 paths)
- GET /llms.txt — LLM discovery summary
- GET /llms-full.txt — This file
- GET /stats/intel — Live service stats (free)
- GET /health — Health check (free)

## Payment Details

- Protocol: x402 (see https://x402.org)
- Supported networks: eip155:8453 (Base), tron:0x2b6653dc (Tron mainnet)
- Base USDC contract: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
- payTo (Base): 0x6961b88476a9b89C4ed97A4aF4D190754d5e70A1
- Tron USDT contract: TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t
- payTo (Tron): TSevuRZFjpckeMSSDhQFoiAkPCkckuE5TP
- Price range: $0.03–$0.10 per call

## Bundles (Multi-Endpoint Passes)

- POST /bundle/purchase/data — Gas + forecast data bundle ($0.10, valid 60s)
- POST /bundle/purchase/all — All Intel Engine endpoints ($0.50, valid 60s)
- GET /v1/bundles — List all available bundles

## Endpoint Categories & Pricing

### Intel Engine
- GET /v1/intel/token — Token enrichment with risk score ($0.08)
- GET /v1/intel/gas — Multi-chain gas prices ($0.03)
- GET /v1/intel/gas/forecast — Gas price forecast with ML ($0.05)
- GET /v1/intel/wallet — Wallet intelligence score ($0.10)

### Base Chain (eip155:8453)
- Token prices, whale wallets, DeFi yields — $0.03–$0.10 per call
- NFT analytics, MEV detection, liquidity pools — $0.03–$0.10 per call
- Wallet analytics, AML screening — $0.03–$0.10 per call

### Tron Chain
- TRC20 tokens, energy/bandwidth markets — $0.03–$0.10 per call
- Stablecoin flows, whale tracking — $0.03–$0.10 per call

### Cross-Chain Verification
- Bitcoin, XRP, Kaspa transaction verification — $0.03–$0.10 per call

### Market Data
- Token unlocks, sentiment, arbitrage — $0.03–$0.10 per call

## MCP Integration

Server: https://bridge.eruditepay.com/.well-known/mcp.json
168 tools available. Install via MCP client pointing to the above descriptor.

## Links

- Service: https://bridge.eruditepay.com
- Discovery: https://bridge.eruditepay.com/.well-known/x402
- OpenAPI: https://bridge.eruditepay.com/openapi.json
- Stats: https://bridge.eruditepay.com/stats/intel