Hunt Townh402
Catalog
CryptoGETlive

Token balance

Fetch an ERC20 token balance for a wallet through OneSource live Ethereum RPC.

$0.003
per call
Success
100%
p50 latency
931ms
p95 latency
1.09s
Calls (30d)
2

Provider contract

Call path
/routes/onesource/crypto/token-balance
Method
GET
Selected provider
onesourcedefault
Provider price
$0.003
Settlement
Base USDC · x402 · 5% h402 fee

Quickstart

Both commands call the selected provider directly.

cURL
curl '/routes/onesource/crypto/token-balance?address=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045&contract=0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48&network=ethereum'
CLI
h402 call 'crypto/token-balance' --provider 'onesource' --method GET --query '{"address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045","contract":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48","network":"ethereum"}'

Parameters & live test

pays real USDC

Fill the request fields, quote the exact per-call total, then choose x402 or eligible bonus credit explicitly before sending. Only the selected provider's listed parameters are accepted.

addressstringrequired

Wallet address whose ERC20 balance should be read.

contractstringrequired

ERC20 token contract address.

networkstringoptionaldefault ethereum

OneSource-supported Ethereum network.

One of
GET/routes/onesource/crypto/token-balance
Request query
{
  "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
  "contract": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
  "network": "ethereum"
}

ResponseExample response
{
  "data": {
    "data": {
      "account": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
      "contract_address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
      "balance": "37192124",
      "symbol": "USDC",
      "name": "USD Coin",
      "decimals": 6
    },
    "meta": {
      "endpoint": "/api/chain/erc20-balance",
      "request_id": "5ba8f31cd2028dfd"
    }
  },
  "h402": {
    "routeId": "crypto/token-balance",
    "provider": "onesource",
    "selectedCandidateId": "crypto/token-balance/onesource",
    "routing": "manual",
    "paidBy": "x402-exact"
  }
}

Providers

Choose a provider for this task. The catalog recommends the current default from quality, reliability, and price; your selected provider stays pinned. Listed prices are provider prices; settlement adds a 5% h402 fee.

onesource
x402mpp
100
Success
100%
p50
931ms
Calls
2
100%
$0.003$0.0030/call
Last successful call: 27d ago· Aggregated by h402 — not the source provider