# rh-chain-intel - 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

### Chain Health  (0.005 USD/call)
POST https://rh-chain-intel.vercel.app/api/health
Live network health of Robinhood Chain (Ethereum L2 on Arbitrum): latest block, average block time, gas prices, total and today's transactions, total addresses, ETH price. No input.

### Wallet Snapshot  (0.01 USD/call)
POST https://rh-chain-intel.vercel.app/api/wallet
Wallet snapshot on Robinhood Chain: ETH balance (+USD), transaction count, account type (wallet/contract), scam and reputation flags, and optionally (deep=true) token holdings. Body: { address, deep? }.

### Wallet Activity Score  (0.01 USD/call)
POST https://rh-chain-intel.vercel.app/api/score
Activity score (0-100) for a Robinhood Chain wallet, derived from transaction count, balance, and token activity, with a tier (dormant/low/moderate/active/very active). Body: { address }.

### Token Screener  (0.008 USD/call)
POST https://rh-chain-intel.vercel.app/api/tokens
Screen tokens on Robinhood Chain sorted by holders: tokenized Stock Tokens (MSTR, GME, ASML, TSM, IonQ...) and community tokens. Filter with stockOnly=true, or a name/symbol query. Body: { query?, stockOnly?, limit? }.

### Token Detail  (0.008 USD/call)
POST https://rh-chain-intel.vercel.app/api/token
Detail for one token on Robinhood Chain by contract address: symbol, name, token type, holders, supply, price, market cap, 24h volume, and whether it is a Robinhood Stock Token. Body: { address }.

### Transaction Lookup  (0.005 USD/call)
POST https://rh-chain-intel.vercel.app/api/tx
Look up a transaction on Robinhood Chain by hash: status, method, from/to, value, fee, block, timestamp, and whether it moved tokens. Body: { hash }.

### Token Rug Check  (0.01 USD/call)
POST https://rh-chain-intel.vercel.app/api/rugcheck
Rug check a token on Robinhood Chain via holder concentration: top holder %, top-10 %, burned %, holder count, and scam flag. Returns GO/CAUTION/DANGER. Catches whale-controlled dump/rug risk on new meme tokens. Does NOT check mint authority, honeypot, or trading tax (GoPlus does not yet support this chain). Body: { address }.

### Trending Tokens  (0.008 USD/call)
POST https://rh-chain-intel.vercel.app/api/trending
Trending tokens on Robinhood Chain by 24h volume: meme/community tokens pumping right now. Stablecoins and wrapped tokens are excluded; Stock Tokens excluded unless includeStock=true. Body: { limit?, includeStock? }.

### Token Burn Stats  (0.005 USD/call)
POST https://rh-chain-intel.vercel.app/api/burn
Burn stats for a token on Robinhood Chain: amount sent to burn addresses (0x0 and 0x...dEaD) and the percentage of total supply burned. 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.