# 402arcade

> Pay-per-call micro-APIs for AI agents. Every endpoint is payable with USDC on Base via the x402 protocol (HTTP 402). No API keys, no accounts, no signup — an agent with a funded wallet can integrate in one request.

Base URL: https://402arcade.dev
Payment: x402 v2, scheme "exact", USDC on Base mainnet (eip155:8453). Unpaid requests return HTTP 402 with a base64 JSON envelope in the `payment-required` header containing price, payTo, and full input/output schemas. Use @x402/fetch (npm) to pay automatically.

## Endpoints
- GET /base/balance — $0.003 — ETH or ERC20 balance for any wallet on Base. Params: address (wallet address (0x…)); token? (ERC20 contract; omit for native ETH)
- GET /base/portfolio — $0.005 — Wallet snapshot: ETH + 10 major Base tokens in one call. Params: address (wallet address (0x…))
- GET /base/resolve — $0.003 — Basename resolution, both directions. Params: name? (name.base.eth to resolve); address? (address for reverse lookup)
- GET /base/nft — $0.005 — NFT metadata (ERC721/1155): collection, owner, traits, image. Params: contract (NFT contract address); tokenId (token id (decimal))
- GET /base/tx — $0.003 — Transaction lookup with decoded ERC20 transfers. Params: hash (transaction hash)
- GET /base/quote — $0.005 — Best-execution DEX swap quote (Uniswap V3 + Aerodrome, multi-hop). Params: tokenIn (token address or ETH/WETH); tokenOut (token address or ETH/WETH); amount (human-units amount of tokenIn)
- GET /base/rugcheck — $0.02 — Token safety screening: ownership, dangerous functions, proxy, liquidity, honeypot heuristic. Params: token (ERC20 contract address)
- GET /base/identity — $0.008 — Identity graph: address ↔ basename ↔ ENS ↔ Farcaster. Params: q (address | name.base.eth | name.eth | fid:N | farcaster username)
- GET /web/markdown — $0.004 — Any public webpage → clean LLM-ready markdown. Params: url (public http(s) URL)
- GET /web/screenshot — $0.015 — PNG screenshot rendered in headless Chromium. Params: url (public http(s) URL); width? (viewport width, max 1920); fullPage? (true for full scroll height)
- GET /web/pdf — $0.02 — Any public webpage → PDF. Params: url (public http(s) URL); format? (A4 (default) or Letter); landscape? (true for landscape)
- POST /batch — $0.02 — Up to 10 data queries in one paid call (bulk discount). Params: calls (body: {calls:[{endpoint,params}]} — data endpoints only)

## Free
- GET /catalog — this catalog as JSON
- GET /openapi.json — OpenAPI 3.1 spec
- GET /healthz — liveness

## Notes for agents
- All prices are per-call, settled on-chain by the Coinbase x402 facilitator; no session state.
- /batch accepts up to 10 data queries in one paid call at a bulk discount (web rendering endpoints excluded).
- /base/rugcheck is heuristic screening from on-chain data, not financial advice.