# booAIP - Crypto data API for AI agents

Pay-per-call crypto/web3 ground-truth data. USDC via x402 on base. No API key, no signup.
Each endpoint is a separate POST route with its own price. Unpaid requests return HTTP 402.

## Endpoints

### Token Price  (0.01 USD/call)
POST https://booaip.vercel.app/api/price
Token price, liquidity, 24h volume and FDV from DEX pairs (DexScreener). Body: { token, chain? }.

### DeFi Protocol TVL  (0.01 USD/call)
POST https://booaip.vercel.app/api/tvl
DeFi protocol TVL, chains and 1d/7d change (DefiLlama). Body: { protocol } using the DefiLlama slug (e.g. aave, uniswap, lido).

### Fear & Greed Index  (0.005 USD/call)
POST https://booaip.vercel.app/api/feargreed
Current crypto Fear & Greed Index with 1-day change (alternative.me). Body: {} (no params).

### Yield Finder  (0.01 USD/call)
POST https://booaip.vercel.app/api/yields
Top APY yield pools by token symbol and chain (DefiLlama). Body: { symbol?, chain?, limit? }.

### Stablecoin Monitor  (0.01 USD/call)
POST https://booaip.vercel.app/api/stablecoins
Stablecoin circulating supply, price and peg deviation (DefiLlama). Body: { symbol? }.

### Chain Overview  (0.01 USD/call)
POST https://booaip.vercel.app/api/chains
Chain TVL, rank and dominance (DefiLlama). Body: { chain? }.

### Gas Oracle  (0.005 USD/call)
POST https://booaip.vercel.app/api/gas
Current gas price (gwei) on an EVM chain via on-chain read. Body: { chain } (eth, bnb, base).

### ENS Resolver  (0.005 USD/call)
POST https://booaip.vercel.app/api/ens
Resolve ENS name to address or reverse-resolve address to name (Ethereum mainnet). Body: { query }.

### Token Supply Info  (0.01 USD/call)
POST https://booaip.vercel.app/api/supply
ERC-20 token name, symbol, decimals and total supply via on-chain read. Body: { token, chain }.

### Wallet Sanctions Screen  (0.01 USD/call)
POST https://booaip.vercel.app/api/sanctions
Screen an EVM wallet against the OFAC SDN crypto address list (PASS/BLOCK). Body: { address }.

## Payment
Unpaid requests return HTTP 402 with an x402 payment requirement (USDC on Base), recipient 0xcd6b6d99b7751ff30b68fa1365488eb73fa7cefa. Pay with an x402 client and retry.