Base wallet balances
Returns the native ETH balance and ERC-20 token balances of one Base wallet address, read live from Base mainnet at the latest block: USDC, WETH and the rest of the top 200 Base tokens by market cap, plus up to 50 token contract addresses named in the request. Each row carries the token symbol, name, decimals, raw amount and human-readable amount. Suited to checking a wallet's current holdings before a payment, transfer or swap; returns no labels, identities, USD values or portfolio valuation.
Offering
- Provider
- api.botx402.io
- Method
- POST
- Offering type
- Api Endpoint
- Transport type
- http
- Category
- Other
- Delivery
- Not provided
- Pricing model
- Not provided
- x402 version
- 2
Endpoint context
- URL
https://api.botx402.io/base-address-balance- MIME type
- application/json
- First seen
- 2026-10-25T21:32:28.588Z
- Last seen
- Tags
- Crypto, Onchain, Base, Wallet
Payment pricing
x402 payment terms are the authoritative price for calling this endpoint.
- Payment option 1
- 0.01 USDC
Atomic price: 10000 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Raw x402 terms
[
{
"scheme": "exact",
"network": "eip155:8453",
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"amount": "10000",
"payTo": "0x007bc3987566F3aca40adC3F36c56207E1E0c2fc"
}
]Observed health
- Status
- Healthy
- Latest latency
- 35 ms
- Average latency
- 38 ms
- HTTP status
- 200
- Last checked
- Reachability
- 100% over 6 checks
Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.
Input schema
{
"additionalProperties": false,
"properties": {
"body": {
"additionalProperties": false,
"description": "One Base wallet address, and optionally ERC-20 token contract addresses to read beyond the fixed list. The request shape of Nansen's profiler/address/current-balance.",
"properties": {
"address": {
"description": "The Base wallet address (0x and 40 hex characters) whose token balances are read.",
"pattern": "^0x[0-9a-fA-F]{40}$",
"type": "string"
},
"chain": {
"description": "The chain to read. Only \"base\" is served; any other value returns 400.",
"type": "string"
},
"filters": {
"description": "Accepted only when empty.",
"maxProperties": 0,
"type": "object"
},
"hide_spam_token": {
"description": "Accepted for compatibility. Holdings come from a fixed list of tokens, so there is no spam to hide.",
"type": "boolean"
},
"order_by": {
"description": "Accepted only when empty. Rows come native token first, then by the token list's rank.",
"maxItems": 0,
"type": "array"
},
"pagination": {
"additionalProperties": false,
"properties": {
"page": {
"minimum": 1,
"type": "integer"
},
"per_page": {
"maximum": 250,
"minimum": 1,
"type": "integer"
}
},
"type": "object"
},
"token_addresses": {
"description": "ERC-20 token contract addresses to read beyond the fixed list of the top 200 Base tokens.",
"items": {
"pattern": "^0x[0-9a-fA-F]{40}$",
"type": "string"
},
"maxItems": 50,
"type": "array",
"uniqueItems": true
}
},
"required": [
"chain",
"address"
],
"type": "object"
},
"bodyType": {
"enum": [
"json",
"form-data",
"text"
],
"type": "string"
},
"method": {
"enum": [
"POST",
"PUT",
"PATCH"
],
"type": "string"
},
"type": {
"const": "http",
"type": "string"
}
},
"required": [
"type",
"method",
"bodyType",
"body"
],
"type": "object"
}Output schema
{
"properties": {
"example": {
"properties": {
"block_number": {
"description": "The Base block every balance was read at.",
"type": "integer"
},
"data": {
"description": "Non-zero balances: native ETH first (token_address is the zero address), then tokens by the list's rank, then caller-supplied tokens.",
"items": {
"properties": {
"address": {
"type": "string"
},
"chain": {
"type": "string"
},
"token_address": {
"type": "string"
},
"token_amount": {
"type": "number"
},
"token_amount_raw": {
"description": "The exact balance in the token's smallest unit.",
"type": "string"
},
"token_decimals": {
"type": "integer"
},
"token_name": {
"type": "string"
},
"token_symbol": {
"type": "string"
}
},
"required": [
"chain",
"address",
"token_address",
"token_symbol",
"token_amount",
"token_amount_raw"
],
"type": "object"
},
"type": "array"
},
"pagination": {
"properties": {
"is_last_page": {
"type": "boolean"
},
"page": {
"type": "integer"
},
"per_page": {
"type": "integer"
}
},
"required": [
"page",
"per_page",
"is_last_page"
],
"type": "object"
}
},
"required": [
"block_number",
"pagination",
"data"
],
"type": "object"
},
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}