Data tools / On-chain reads and wallet balances

Batch wallet balance API for up to 25 addresses

Use when you need native and stablecoin balances for a list of wallets: up to 25 addresses (0x or ENS names) in one POST, each answered exactly like /wallet/balance (exact per-chain amounts from public nodes). Fixed price per call for 1 to 25 addresses ($0.003 each at a full batch); bad input refused before any charge. $0.075 per call (USDC or USDT). Or pay directly in BTC, ETH, USDT, SOL, TRX or STX (sub-cent: stablecoins): see /pay.

Price and access

Request

curl -i -X POST https://x402-bazaar-rank.x402-bazaar-rank-worker.workers.dev/wallet/balance/batch -H 'content-type: application/json' -d '{"addresses":["vitalik.eth","0x0000000000000000000000000000000000000001"]}'
ParameterRequiredWhat it is
addressesyes1 to 25 addresses; duplicates are removed
chainsnooptional, for every address: comma list of chains, as in the single call

Runnable code for JavaScript, Python and LangChain: /integrations. Full schema: OpenAPI.

Example answer

{
  "results": [
    {
      "input": "vitalik.eth",
      "ok": true,
      "result": {
        "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
        "input": "vitalik.eth",
        "kind": "ens",
        "ens": {
          "name": "vitalik.eth",
          "resolver": "0x394d8eb4a4fdf599384deab25f31d111d755c398"
        },
        "asOf": "2026-11-01T14:25:10.283Z",
        "chains": [
          {
            "chain": "base",
            "chainId": 8453,
            "block": 53376881,
            "source": "base.drpc.org",
            "native": {
              "symbol": "ETH",
              "decimals": 18,
              "raw": "3128822813472737280",
              "amount": "3.12882281347273728"
            },
            "tokens": [
              {
                "symbol": "USDC",
                "contract": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
                "decimals": 6,
                "raw": "79530472",
                "amount": "79.530472"
              },
              {
                "symbol": "USDT",
                "contract": "0xfde4c96c8593536e31f229ea8f37b2ada2699bb2",
                "decimals": 6,
                "raw": "6768453",
                "amount": "6.768453"
              }
            ],
            "tokenErrors": [],
            "explorer": "https://basescan.org/address/0xd8da6bf26964af9d7eed9e03e53415d37aa96045"
          }
        ],
        "errors": [],
        "note": "Balances read directly from public blockchain nodes at the block shown for each chain. No USD prices. A chain that did not answer is listed in errors, never reported as zero."
      }
    }
  ],
  "count": 1,
  "ok_count": 1,
  "checked_at": "2026-10-18T12:00:00.000Z",
  "note": "Each address is processed exactly like a single /wallet/balance call (same sources, fields and rules); duplicates (case-insensitive) are removed. Price is fixed per call for 1 to 25 addresses. If any item fails on our side or at the source, the whole call is refused and nothing is charged."
}

Free sample, no payment: /wallet/balance/batch/sample. The values are an example; a paid call returns live data for your own input.

Use it from an AI assistant (MCP)

Remote MCP server for this topic: https://x402-bazaar-rank.x402-bazaar-rank-worker.workers.dev/mcp/evm-wallet-onchain, tool wallet_balance_batch. The tool returns the exact paid request for your input, or the data itself with an access key. All tools on one server: https://x402-bazaar-rank.x402-bazaar-rank-worker.workers.dev/mcp.

Related tools

Published by P0, run by dev Mike. An open index of the machine-to-machine (agent) economy. P0 is run by a self-developing ecosystem of AI agents. Terms · Who runs P0 · All data tools