# booAIP - Crypto data API for AI agents

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

## Endpoints

### Token Price & Liquidity  (0.01 USD/call)
POST https://booapi-tempo.vercel.app/api/price
Live price, USD liquidity, 24h volume, FDV and market cap for any token, sourced from the deepest DEX pair on DexScreener. Use this when an agent needs the current market value or tradability of a specific token contract before quoting, swapping, or reporting. Fits naturally before a swap, in a portfolio readout, or as the market leg of a token research workflow.

### DeFi Protocol TVL  (0.01 USD/call)
POST https://booapi-tempo.vercel.app/api/tvl
Total value locked for a DeFi protocol, the chains it spans, and 1-day / 7-day change, from DefiLlama. Use when an agent needs to size or compare a protocol's footprint, or detect TVL inflows/outflows, inside a DeFi research or risk workflow.

### Crypto Fear & Greed Index  (0.005 USD/call)
POST https://booapi-tempo.vercel.app/api/feargreed
The current crypto Fear & Greed Index (0 = extreme fear, 100 = extreme greed) with its 1-day change, from alternative.me. Use when an agent needs a quick market-wide sentiment read to frame a recommendation or condition a strategy. No parameters.

### DeFi Yield Finder  (0.01 USD/call)
POST https://booapi-tempo.vercel.app/api/yields
Top APY yield pools filtered by token symbol and/or chain, from DefiLlama, optionally restricted to lower-risk pools. Use when an agent needs to find where an asset can earn yield, inside a treasury, allocation, or 'where to park stablecoins' workflow.

### Stablecoin Peg Monitor  (0.01 USD/call)
POST https://booapi-tempo.vercel.app/api/stablecoins
Circulating supply, current price and peg deviation for a stablecoin (or the top 10), from DefiLlama. Use when an agent needs to verify a stablecoin is holding its peg or size its market, inside a risk-check or treasury workflow before holding/accepting it.

### Chain TVL Overview  (0.01 USD/call)
POST https://booapi-tempo.vercel.app/api/chains
Total value locked, rank and dominance for a blockchain (or the top 10), from DefiLlama. Use when an agent needs to compare chains by DeFi size or gauge where activity concentrates, inside a market-structure or chain-selection workflow.

### EVM Gas Oracle  (0.005 USD/call)
POST https://booapi-tempo.vercel.app/api/gas
Current gas price in gwei for an EVM chain, read directly on-chain. Use when an agent needs to estimate transaction cost or decide timing before broadcasting a transaction, inside an execution workflow.

### ENS Name Resolver  (0.005 USD/call)
POST https://booapi-tempo.vercel.app/api/ens
Resolve an ENS name to its address, or reverse-resolve an address to its primary ENS name, on Ethereum mainnet. Use when an agent needs to turn a human-readable name into an address (or vice versa) before paying, labeling, or displaying a counterparty.

### Token Supply Info  (0.01 USD/call)
POST https://booapi-tempo.vercel.app/api/supply
Name, symbol, decimals and total supply for an ERC-20 token, read directly on-chain. Use when an agent needs authoritative token metadata and supply (not market-derived) before calculating amounts, market cap, or verifying a token.

### Wallet OFAC Sanctions Screen  (0.01 USD/call)
POST https://booapi-tempo.vercel.app/api/sanctions
Screen an EVM wallet against the OFAC SDN crypto address list and return a clear PASS or BLOCK. Use when an agent must run a compliance check before sending funds to, or accepting funds from, a counterparty address. A pure compliance gate.

### Token Snapshot (price + supply + safety)  (0.015 USD/call)
POST https://booapi-tempo.vercel.app/api/snapshot
One call that combines market data (price, liquidity, volume), on-chain supply, and GoPlus safety flags into a single OK / CAUTION / DANGER read. Use when an agent needs a complete go/no-go picture of a token without chaining three separate calls. The fastest token due-diligence primitive; ideal as the first step of any 'should I touch this token' workflow.

### Wallet Risk Profile  (0.01 USD/call)
POST https://booapi-tempo.vercel.app/api/wallet
A snapshot risk profile of an EVM wallet from direct RPC reads plus OFAC screening: native balance, transaction count and activity level, contract-vs-EOA status, sanctions verdict, whale flag, and a heuristic 0-100 wallet score. Use when an agent needs to assess a counterparty wallet before transacting. Snapshot only: wallet age and DeFi/bridge/NFT history require an indexer and are not included.

### Multi-Exchange Perp Funding & Open Interest  (0.01 USD/call)
POST https://booapi-tempo.vercel.app/api/derivatives
Perpetual funding rate and open interest for a coin across Binance, Bybit, OKX and Hyperliquid in a single call, with funding normalized to annualized APR for fair cross-venue comparison, the funding spread between venues (a funding-arbitrage / divergence signal), total open interest in USD, and a funding-based sentiment read (crowded long / short). Use when an agent needs derivatives positioning to gauge market sentiment, detect crowding, or spot a cross-venue funding edge before taking or sizing a position. Public exchange data; signals are heuristic, not financial advice.

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