---
title: "Base wallet balances"
method: GET
path: "/api/x402/base/balances"
tags: ["base-onchain-data", "x402-paid"]
---

# Base wallet balances

`GET /api/x402/base/balances`

## Request

- Base URL: `https://ontarioprotocol.com`
- URL: `https://ontarioprotocol.com/api/x402/base/balances`
- Auth: none required

ETH, USDC and about 25 widely held Base tokens with a nonzero balance, plus up to 20 named ERC-20 contracts, with symbol, decimals, raw and formatted amounts and the block read, live from Base RPC. 0.002 USDC on Base; a failed read is not charged. No prices or USD values.

## Query parameters

- `address` string, required
- `tokens` string

## Response `200`

Successful live read; the payment settled

- object
  - `address` string, required
  - `block` integer, required
  - `block_timestamp` string, nullable
  - `coverage` object
  - `coverage_note` string
  - `native` object, required
    - `decimals` unknown, required
    - `formatted` string, required
    - `raw` string, required
    - `symbol` 'ETH', required
  - `network` 'eip155:8453', required
  - `read_at` string, required
  - `schema` 'ontario.base_balances.v1', required
  - `source` 'Base RPC', required
  - `tokens` object[], required
    - `address` string, required
    - `decimals` integer, nullable, required
    - `formatted` string, nullable, required
    - `raw` string, nullable, required
    - `source` 'default_list' | 'requested', required
    - `symbol` string, nullable, required

## Other responses

- `400`: Signed request refused before settlement; no payment taken
- `402`: x402 payment challenge (every unsigned request)
- `503`: Base RPC unavailable; payment not settled

## Changes

- **2026-10-25** `39920cff9aa5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ontarioprotocol/apis/ontario-protocol-x402-api/changes/api/x402/base/balances/get.md)

---

[API](https://skmtc.dev/ontarioprotocol/apis/ontario-protocol-x402-api.md) - [All operations](https://skmtc.dev/ontarioprotocol/apis/ontario-protocol-x402-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ontarioprotocol/apis/ontario-protocol-x402-api/revisions/c4bb7fd32b2f?raw)