Api Endpoint

Base wallet and ERC-20 balance

Base wallet balance for any address: ETH, USDC and about 25 widely held Base tokens, plus up to 20 ERC-20 token contracts you name, each with symbol, decimals, raw and formatted amount and the block number read, live from Base mainnet RPC. Required: address. $0.002 USDC on Base. Failed read, no charge. No account, no API key. Base mainnet only; no prices or USD values; tokens outside the list and your extras are not discovered. By Ontario Protocol.

Open interactive test console

Offering

Provider
ontarioprotocol.com
Method
GET
Offering type
Api Endpoint
Transport type
http
Category
Other
Delivery
Not provided
Pricing model
Not provided
x402 version
2

Endpoint context

URL
https://ontarioprotocol.com/api/x402/base/balances
MIME type
application/json
First seen
2026-10-26T21:37:17.077Z
Last seen
Tags
Base wallet balance, erc20 token balance, USDC balance, Wallet, Base, wallet balances

Payment pricing

x402 payment terms are the authoritative price for calling this endpoint.

Payment option 1
0.002 USDC
Atomic price: 2000 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Raw x402 terms
[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "2000",
    "payTo": "0xa2d72aBF2C5e939fdDCA4156B74dE482e03CA3ec"
  }
]

Observed health

Status
Healthy
Latest latency
113 ms
Average latency
1660 ms
HTTP status
402
Last checked
Reachability
100% over 5 checks

Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.

Input schema

{
  "properties": {
    "queryParams": {
      "additionalProperties": false,
      "properties": {
        "address": {
          "description": "Base wallet or contract address to read.",
          "pattern": "^0x[0-9a-fA-F]{40}$",
          "type": "string"
        },
        "tokens": {
          "description": "Optional comma-separated ERC-20 contract addresses to read as well, max 20.",
          "type": "string"
        }
      },
      "required": [
        "address"
      ],
      "type": "object"
    }
  },
  "required": [
    "queryParams"
  ],
  "type": "object"
}

Output schema

{
  "properties": {
    "example": {
      "additionalProperties": true,
      "type": "object"
    }
  },
  "required": [
    "example"
  ],
  "type": "object"
}