{"openapi":"3.1.0","info":{"title":"On-chain Data for Agents (x402)","version":"2.0.0","description":"Pay-per-call on-chain data for AI agents on Base, Ethereum, Arbitrum, Optimism and Polygon: wallet balances, transaction status, contract and token inspection, ENS and Basename resolution. USDC on Base via x402, no API key.","x-guidance":"GET /balances ($0.002): Wallet balances on five EVM chains. GET /tx ($0.002): Transaction status and receipt by hash, chain auto-detected. GET /contract ($0.002): Is it a contract, a proxy or a token, on five chains. GET /ens ($0.001): ENS / Basename to address, or address to primary name. Pay in USDC on Base via x402."},"servers":[{"url":"https://x402-wallet-balances.vercel.app"}],"paths":{"/balances":{"get":{"operationId":"getBalances","summary":"Wallet balances on five EVM chains","description":"Wallet balances across Base, Ethereum, Arbitrum, Optimism and Polygon in one call: native coin, USDC, USDT, DAI and up to 10 extra ERC-20 tokens, read live via Multicall3 with RPC failover. Per-chain status; not charged if every chain fails. No API key.","tags":["Multichain Wallet Balances"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.002"},"protocols":[{"x402":{}}]},"parameters":[{"name":"address","in":"query","required":true,"schema":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"EVM wallet address to read"}},{"name":"chains","in":"query","required":false,"schema":{"type":"string","description":"Comma list, any of: base,ethereum,arbitrum,optimism,polygon. Default: all five."}},{"name":"tokens","in":"query","required":false,"schema":{"type":"string","description":"Optional comma list of up to 10 extra ERC-20 contract addresses, read on every requested chain"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"},"example":{"address":"0x2a15C6A98324e179dD9adf87bDD59F9C77f19d12","fetchedAt":"2026-11-15T17:30:00.000Z","chainsOk":1,"chainsFailed":0,"stablecoinFaceValueUsd":12.5,"chains":[{"chain":"base","chainId":8453,"status":"ok","blockNumber":"38123456","native":{"symbol":"ETH","raw":"1000000000000000","formatted":"0.001"},"tokens":[{"address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC","decimals":6,"raw":"12500000","formatted":"12.5"}],"stablecoinFaceValueUsd":12.5}]}}}},"400":{"description":"bad input (not charged)"},"402":{"description":"Payment Required"},"502":{"description":"every requested chain unavailable (not charged)"}}}},"/tx":{"get":{"operationId":"getTransaction","summary":"Transaction status and receipt by hash, chain auto-detected","description":"Transaction status by hash on Base, Ethereum, Arbitrum, Optimism and Polygon; the chain is found for you. Returns success, reverted or pending, block, confirmations, timestamp, from, to, value, fee (L1 fee included on OP chains), created contract and log count. Full history via archive RPCs. Not charged when the hash is not found (404) or every chain fails (502). No API key.","tags":["Multichain Transaction Lookup"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.002"},"protocols":[{"x402":{}}]},"parameters":[{"name":"hash","in":"query","required":true,"schema":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$","description":"Transaction hash (0x + 64 hex)"}},{"name":"chains","in":"query","required":false,"schema":{"type":"string","description":"Comma list, any of: base,ethereum,arbitrum,optimism,polygon. Default: all five. Narrowing it is optional; the hash is looked up on every listed chain."}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"},"example":{"hash":"0x5c504ed432cb51138bcf09aa5e8a410dd4a1e204ef84bfed1be16dfba1b22060","chain":"ethereum","chainId":1,"from":"0xA1E4380A3B1f749673E270229993eE55F35663b4","to":"0x5DF9B87991262F6BA471F09758CDE1c0FC1De734","nonce":0,"value":{"symbol":"ETH","raw":"31337","formatted":"0.000000000000031337"},"methodId":null,"status":"mined","blockNumber":"46147","confirmations":26377499,"timestamp":"2015-08-07T03:30:33.000Z","gasUsed":"21000","effectiveGasPrice":"50000000000000","fee":{"symbol":"ETH","raw":"1050000000000000000","formatted":"1.05","includesL1Fee":false},"contractCreated":null,"logCount":0,"chainsFailed":[]}}}},"400":{"description":"bad input (not charged)"},"402":{"description":"Payment Required"},"404":{"description":"hash not found on any requested chain (not charged)"},"502":{"description":"every requested chain unavailable (not charged)"}}}},"/contract":{"get":{"operationId":"inspectContract","summary":"Is it a contract, a proxy or a token, on five chains","description":"Inspect any address on Base, Ethereum, Arbitrum, Optimism and Polygon in one call: wallet or contract, bytecode size and hash, EIP-7702 delegation, proxy type and implementation/admin/beacon (EIP-1967, beacon, EIP-1167 clones, legacy ZeppelinOS such as USDC), and token standard with on-chain name, symbol, decimals and total supply (ERC-20, ERC-721, ERC-1155). Not charged if every chain fails. No API key.","tags":["Contract Inspector"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.002"},"protocols":[{"x402":{}}]},"parameters":[{"name":"address","in":"query","required":true,"schema":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"Address to inspect"}},{"name":"chains","in":"query","required":false,"schema":{"type":"string","description":"Comma list, any of: base,ethereum,arbitrum,optimism,polygon. Default: all five."}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"},"example":{"address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","fetchedAt":"2026-11-15T23:20:00.000Z","chainsOk":1,"chainsFailed":0,"deployedOn":["base"],"chains":[{"chain":"base","chainId":8453,"status":"ok","codeSize":1852,"codeHash":"0xa6705a10bb756b5dea144591118be77d7af0c3eee3bf2dfe2583dcb0364fefab","kind":"contract","delegatedTo":null,"proxy":{"standard":"zeppelinos-legacy","implementation":"0x2Ce6311ddAE708829bc0784C967b7d77D19FD779","admin":"0x4fc7850364958d97B4d3f5A08f79db2493f8cA44","beacon":null},"token":{"standard":"erc20","name":"USD Coin","symbol":"USDC","decimals":6,"totalSupply":"4123456789000000","totalSupplyFormatted":"4123456789"}}]}}}},"400":{"description":"bad input (not charged)"},"402":{"description":"Payment Required"},"502":{"description":"every requested chain unavailable (not charged)"}}}},"/ens":{"get":{"operationId":"resolveEns","summary":"ENS / Basename to address, or address to primary name","description":"Resolve an ENS name or a Base Basename (name.base.eth) to its address, or an address to its verified primary name, on-chain through the ENS Universal Resolver with CCIP-Read. Pass name or address. Not charged when nothing resolves (404) or the chain fails (502). No API key.","tags":["ENS and Basename Resolver"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocols":[{"x402":{}}]},"parameters":[{"name":"name","in":"query","required":false,"schema":{"type":"string","description":"ENS name or Basename, e.g. vitalik.eth or jesse.base.eth (use this or address)"}},{"name":"address","in":"query","required":false,"schema":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"Address to reverse-resolve to its primary name (use this or name)"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"},"example":{"direction":"forward","name":"vitalik.eth","address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"}}}},"400":{"description":"bad input (not charged)"},"402":{"description":"Payment Required"},"404":{"description":"no address or primary name (not charged)"},"502":{"description":"chain unavailable (not charged)"}}}},"/":{"get":{"security":[],"summary":"Docs page","responses":{"200":{"description":"OK"}}}},"/health":{"get":{"security":[],"summary":"Health check","responses":{"200":{"description":"OK"}}}},"/llms.txt":{"get":{"security":[],"summary":"LLM summary","responses":{"200":{"description":"OK"}}}}}}