# STONKSCAN

> STONKSCAN (https://stonkscan.xyz) is the first real-time token screener and non-custodial trading terminal for chain 4663 ("Robinhood Chain", an Arbitrum Orbit L2, chainId 4663, RPC https://rpc.mainnet.chain.robinhood.com). Live pairs, market caps, OHLCV charts, trades, token security checks, in-app bridging, and Uniswap swaps signed in the user's own wallet. Independent project — not affiliated with Robinhood Markets, Inc. Nothing here is financial advice.

Key facts for agents:
- Chain: 4663 (0x1237), gas token ETH, ~100ms blocks, explorer https://robinhoodchain.blockscout.com
- Swaps route through Uniswap SwapRouter02 0xCaf681a66D020601342297493863E78C959E5cb2 (verified). WETH: 0x0bd7d308f8e1639fab988df18a8011f41eacad73
- Amounts on this chain's meme tokens are conventionally discussed in MARKET CAP, not price.
- Interface fees: 1% on swaps, 0.5% on in-app bridging (via Relay).

## Pages
- [Screener](https://stonkscan.xyz/): live table (trending/gainers/new/volume), per-pair drawer with chart + trades + security. Deep link: /?pair=<poolAddress>
- [Share pages](https://stonkscan.xyz/s/<poolAddress>): per-token page with live OG meta, redirects humans to the app
- [About](https://stonkscan.xyz/about.html): what it is, how swaps work, fees, FAQ

## Public API (free, no key, JSON)
- Pairs list: `GET https://stonkscan.xyz/api/gt?path=%2Fnetworks%2Frobinhood%2Ftrending_pools%3Finclude%3Dbase_token%2Cquote_token%26page%3D1` (GeckoTerminal passthrough scoped to this chain; also new_pools, /pools/<addr>, /pools/<addr>/ohlcv/<minute|hour|day>, /pools/<addr>/trades)
- Token security: `GET https://stonkscan.xyz/api/security?token=<tokenAddress>&pool=<poolAddress>` → {verified, renounced, owner, top10PctExPool, holdersCount}
- Chain state: `GET https://stonkscan.xyz/api/rpc?method=eth_gasPrice` (also eth_blockNumber, eth_chainId)

## MCP (Model Context Protocol)
- Streamable HTTP endpoint: `https://stonkscan.xyz/api/mcp` — tools: get_trending_pairs, get_new_pairs, get_pair, get_token_security. Stateless; POST JSON-RPC 2.0.

## Data sources
- GeckoTerminal (CoinGecko) market data, Blockscout explorer data, chain RPC.