On-chain data for agents, one paid call at a time
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.
| endpoint | what it answers | price |
|---|---|---|
GET /balances | Wallet balances on five EVM chains | $0.002 per call |
GET /tx | Transaction status and receipt by hash, chain auto-detected | $0.002 per call |
GET /contract | Is it a contract, a proxy or a token, on five chains | $0.002 per call |
GET /ens | ENS / Basename to address, or address to primary name | $0.001 per call |
How paying works
Without payment every endpoint answers 402 Payment Required with a PAYMENT-REQUIRED header.
An x402 client (for example @x402/fetch, AgentCash, or any Bazaar-aware agent) signs a USDC authorization and retries
with PAYMENT-SIGNATURE. Settlement runs only after a successful response: bad input, nothing found, or every chain down is not charged.
GET /balances: Wallet balances on five EVM chains
$0.002 per call
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.
GET https://x402-wallet-balances.vercel.app/balances?address=0x2a15C6A98324e179dD9adf87bDD59F9C77f19d12&chains=base,ethereum
| param | required | meaning |
|---|---|---|
address | yes | EVM wallet address to read |
chains | no | Comma list, any of: base,ethereum,arbitrum,optimism,polygon. Default: all five. |
tokens | no | Optional comma list of up to 10 extra ERC-20 contract addresses, read on every requested chain |
Example response
{
"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
}
]
}Not charged: 400 bad input, 502 every requested chain unavailable.
GET /tx: Transaction status and receipt by hash, chain auto-detected
$0.002 per call
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.
GET https://x402-wallet-balances.vercel.app/tx?hash=0x5c504ed432cb51138bcf09aa5e8a410dd4a1e204ef84bfed1be16dfba1b22060
| param | required | meaning |
|---|---|---|
hash | yes | Transaction hash (0x + 64 hex) |
chains | no | 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. |
Example response
{
"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": []
}Not charged: 400 bad input, 404 hash not found on any requested chain, 502 every requested chain unavailable.
GET /contract: Is it a contract, a proxy or a token, on five chains
$0.002 per call
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.
GET https://x402-wallet-balances.vercel.app/contract?address=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913&chains=base
| param | required | meaning |
|---|---|---|
address | yes | Address to inspect |
chains | no | Comma list, any of: base,ethereum,arbitrum,optimism,polygon. Default: all five. |
Example response
{
"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"
}
}
]
}Not charged: 400 bad input, 502 every requested chain unavailable.
GET /ens: ENS / Basename to address, or address to primary name
$0.001 per call
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.
GET https://x402-wallet-balances.vercel.app/ens?name=vitalik.eth
| param | required | meaning |
|---|---|---|
name | no | ENS name or Basename, e.g. vitalik.eth or jesse.base.eth (use this or address) |
address | no | Address to reverse-resolve to its primary name (use this or name) |
Example response
{
"direction": "forward",
"name": "vitalik.eth",
"address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
}Not charged: 400 bad input, 404 no address or primary name, 502 chain unavailable.
Payment details
| network | eip155:8453 (Base mainnet) |
| asset | USDC |
| pay to | 0x2a15C6A98324e179dD9adf87bDD59F9C77f19d12 |
| scheme | exact, x402 v2, Coinbase CDP facilitator |