Onchain Router Base Mainnet
Base mainnet · USDC paymentsAny verified wallet can pay. Check every payment term and set a local spending limit before signing.

Developer documentation

Check a Base wallet USDC balance

Request fields, payment behavior, response details, and errors for /v1/balance.

Page tools

Check a Base wallet USDC balance

GET /v1/balance

Operation ID: getWalletBalance. The canonical machine-readable schema is OpenAPI.

Check a wallet

Pass a public Base wallet address as the required address query parameter, for example GET /v1/balance?address=0x1111111111111111111111111111111111111111. This free, rate-limited chain read does not connect the wallet or request a signature.

Responses

  • 200: Current Base USDC wallet balance
  • 400: Invalid or missing Base wallet address
  • 503: Base balance lookup temporarily unavailable
Reviewed 2026-08-21Catalog d815ab0e8989

Search guides, endpoint references, models, and pricing.