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.
The wallet the 402 directs payment to. Its whole payment record — every payer, every chain — is on the merchant page.
Asset 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
The payTo wallet does not resolve to a registered ERC-8004 agent. That is not a verdict on the service — most of the catalog is unregistered.
Live 402 challenge
Captured by the enrichment pass, not read just now. Prices can change — always read the 402 the endpoint answers with.
{
"error": "Payment required for this resource.",
"accepts": [
{
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0x007bc3987566F3aca40adC3F36c56207E1E0c2fc",
"amount": "10000",
"scheme": "exact",
"network": "eip155:8453",
"maxTimeoutSeconds": 300
}
],
"resource": {
"url": "https://api.botx402.io/base-address-balance",
"tags": [
"crypto",
"onchain",
"base",
"wallet"
],
"iconUrl": "https://botx402.io/icon-512.png",
"mimeType": "application/json",
"description": "Returns the native ETH balance and ERC-20 token holdings of one Base address, read at the latest block: the top 200 Base tokens by market cap, plus up to 50 token contracts named in the request. Suited to tasks that need a current balance or holdings list for a known address; returns no labels, identities or USD values.",
"serviceName": "botx402 balances"
},
"extensions": {
"bazaar": {
"info": {
"input": {
"body": {
"chain": "base",
"address": "0x28c6c06298d514db089934071355e5743bf21d60",
"pagination": {
"page": 1,
"per_page": 10
}
},
"type": "http",
"method": "POST",
"bodyType": "json"
},
"output": {
"type": "json",
"example": {
"data": [
{
"chain": "base",
"address": "0x28c6c06298d514db089934071355e5743bf21d60",
"token_name": "Ether",
"token_amount": 0.009976650767481596,
"token_symbol": "ETH",
"token_address": "0x0000000000000000000000000000000000000000",
"token_decimals": 18,
"token_amount_raw": "9976650767481597"
},
{
"chain": "base",
"address": "0x28c6c06298d514db089934071355e5743bf21d60",
"token_name": "USD Coin",
"token_amount": 604.382274,
"token_symbol": "USDC",
"token_address": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
"token_decimals": 6,
"token_amount_raw": "604382274"
},
{
"chain": "base",
"address": "0x28c6c06298d514db089934071355e5743bf21d60",
"token_name": "Wrapped Ether",
"token_amount": 1.8e-17,
"token_symbol": "WETH",
"token_address": "0x4200000000000000000000000000000000000006",
"token_decimals": 18,
"token_amount_raw": "18"
},
{
"chain": "base",
"address": "0x28c6c06298d514db089934071355e5743bf21d60",
"token_name": "Brett",
"token_amount": 1,
"token_symbol": "BRETT",
"token_address": "0x532f27101965dd16442e59d40670faf5ebb142e4",
"token_decimals": 18,
"token_amount_raw": "1000000000000000000"
},
{
"chain": "base",
"address": "0x28c6c06298d514db089934071355e5743bf21d60",
"token_name": "B3",
"token_amount": 341.495916229358,
"token_symbol": "B3",
"token_address": "0xb3b32f9f8827d4634fe7d973fa1034ec9fddb3b3",
"token_decimals": 18,
"token_amount_raw": "341495916229358000000"
},
{
"chain": "base",
"address": "0x28c6c06298d514db089934071355e5743bf21d60",
"token_name": "Edel",
"token_amount": 208923,
"token_symbol": "EDEL",
"token_address": "0xfb31f85a8367210b2e4ed2360d2da9dc2d2ccc95",
"token_decimals": 18,
"token_amount_raw": "208923000000000000000000"
}
],
"pagination": {
"page": 1,
"per_page": 10,
"is_last_page": true
},
"block_number": 52943289
}
}
},
"schema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"input"
],
"properties": {
"input": {
"type": "object",
"required": [
"type",
"method",
"bodyType",
"body"
],
"properties": {
"body": {
"type": "object",
"required": [
"chain",
"address"
],
"properties": {
"chain": {
"type": "string",
"description": "The chain to read. Only \"base\" is served; any other value returns 400."
},
"tokens": {
"type": "array",
"items": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$"
},
"maxItems": 50,
"description": "ERC-20 contract addresses to read beyond the fixed list.",
"uniqueItems": true
},
"address": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$",
"description": "The Base address whose balances are read."
},
"filters": {
"type": "object",
"description": "Accepted only when empty.",
"maxProperties": 0
},
"order_by": {
"type": "array",
"maxItems": 0,
"description": "Accepted only when empty. Rows come native token first, then by the token list's rank."
},
"pagination": {
"type": "object",
"properties": {
"page": {
"type": "integer",
"minimum": 1
},
"per_page": {
"type": "integer",
"maximum": 250,
"minimum": 1
}
},
"additionalProperties": false
},
"hide_spam_token": {
"type": "boolean",
"description": "Accepted for compatibility. Holdings come from a fixed list of tokens, so there is no spam to hide."
}
},
"description": "Nansen's profiler/address/current-balance input (what a roaming client matches on), address only, plus tokens.",
"additionalProperties": false
},
"type": {
"type": "string",
"const": "http"
},
"method": {
"enum": [
"POST",
"PUT",
"PATCH"
],
"type": "string"
},
"bodyType": {
"enum": [
"json",
"form-data",
"text"
],
"type": "string"
}
},
"additionalProperties": false
},
"output": {
"type": "object",
"required": [
"type"
],
"properties": {
"type": {
"type": "string"
},
"example": {
"type": "object",
"required": [
"block_number",
"pagination",
"data"
],
"properties": {
"data": {
"type": "array",
"items": {
"type": "object",
"required": [
"chain",
"address",
"token_address",
"token_symbol",
"token_amount",
"token_amount_raw"
],
"properties": {
"chain": {
"type": "string"
},
"address": {
"type": "string"
},
"token_name": {
"type": "string"
},
"token_amount": {
"type": "number"
},
"token_symbol": {
"type": "string"
},
"token_address": {
"type": "string"
},
"token_decimals": {
"type": "integer"
},
"token_amount_raw": {
"type": "string",
"description": "The exact balance in the token's smallest unit."
}
}
},
"description": "Non-zero balances: native ETH first (token_address is the zero address), then tokens by the list's rank, then caller-supplied tokens."
},
"pagination": {
"type": "object",
"required": [
"page",
"per_page",
"is_last_page"
],
"properties": {
"page": {
"type": "integer"
},
"per_page": {
"type": "integer"
},
"is_last_page": {
"type": "boolean"
}
}
},
"block_number": {
"type": "integer",
"description": "The Base block every balance was read at."
}
}
}
}
}
}
}
}
},
"x402Version": 2
}Accepts
The payment requirements as published to the catalog. Read the live 402 before paying — a price here is a claim, not a quote.
Pay 0.01 USDC on Base to 0x007b…0c2fc. The signed payment is good for 5 minutes.
- Paid to
- 0x007b…0c2fc
- USD Coin contract
- 0x8335…02913
- Payment window
- 5 minutes
- As published
- 10000 smallest units
The catalog’s raw entry
[
{
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0x007bc3987566F3aca40adC3F36c56207E1E0c2fc",
"amount": "10000",
"scheme": "exact",
"network": "eip155:8453",
"maxTimeoutSeconds": 300
}
]Extensions
{
"bazaar": {
"info": {
"input": {
"body": {
"chain": "base",
"address": "0x28c6c06298d514db089934071355e5743bf21d60",
"pagination": {
"page": 1,
"per_page": 10
}
},
"type": "http",
"method": "POST",
"bodyType": "json"
},
"output": {
"type": "json",
"example": {
"data": [
{
"chain": "base",
"address": "0x28c6c06298d514db089934071355e5743bf21d60",
"token_name": "Ether",
"token_amount": 0.009976650767481596,
"token_symbol": "ETH",
"token_address": "0x0000000000000000000000000000000000000000",
"token_decimals": 18,
"token_amount_raw": "9976650767481597"
},
{
"chain": "base",
"address": "0x28c6c06298d514db089934071355e5743bf21d60",
"token_name": "USD Coin",
"token_amount": 604.382274,
"token_symbol": "USDC",
"token_address": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
"token_decimals": 6,
"token_amount_raw": "604382274"
},
{
"chain": "base",
"address": "0x28c6c06298d514db089934071355e5743bf21d60",
"token_name": "Wrapped Ether",
"token_amount": 1.8e-17,
"token_symbol": "WETH",
"token_address": "0x4200000000000000000000000000000000000006",
"token_decimals": 18,
"token_amount_raw": "18"
},
{
"chain": "base",
"address": "0x28c6c06298d514db089934071355e5743bf21d60",
"token_name": "Brett",
"token_amount": 1,
"token_symbol": "BRETT",
"token_address": "0x532f27101965dd16442e59d40670faf5ebb142e4",
"token_decimals": 18,
"token_amount_raw": "1000000000000000000"
},
{
"chain": "base",
"address": "0x28c6c06298d514db089934071355e5743bf21d60",
"token_name": "B3",
"token_amount": 341.495916229358,
"token_symbol": "B3",
"token_address": "0xb3b32f9f8827d4634fe7d973fa1034ec9fddb3b3",
"token_decimals": 18,
"token_amount_raw": "341495916229358000000"
},
{
"chain": "base",
"address": "0x28c6c06298d514db089934071355e5743bf21d60",
"token_name": "Edel",
"token_amount": 208923,
"token_symbol": "EDEL",
"token_address": "0xfb31f85a8367210b2e4ed2360d2da9dc2d2ccc95",
"token_decimals": 18,
"token_amount_raw": "208923000000000000000000"
}
],
"pagination": {
"page": 1,
"per_page": 10,
"is_last_page": true
},
"block_number": 52943289
}
}
},
"schema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"input"
],
"properties": {
"input": {
"type": "object",
"required": [
"type",
"method",
"bodyType",
"body"
],
"properties": {
"body": {
"type": "object",
"required": [
"chain",
"address"
],
"properties": {
"chain": {
"type": "string",
"description": "The chain to read. Only \"base\" is served; any other value returns 400."
},
"address": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$",
"description": "The Base wallet address (0x and 40 hex characters) whose token balances are read."
},
"filters": {
"type": "object",
"description": "Accepted only when empty.",
"maxProperties": 0
},
"order_by": {
"type": "array",
"maxItems": 0,
"description": "Accepted only when empty. Rows come native token first, then by the token list's rank."
},
"pagination": {
"type": "object",
"properties": {
"page": {
"type": "integer",
"minimum": 1
},
"per_page": {
"type": "integer",
"maximum": 250,
"minimum": 1
}
},
"additionalProperties": false
},
"hide_spam_token": {
"type": "boolean",
"description": "Accepted for compatibility. Holdings come from a fixed list of tokens, so there is no spam to hide."
},
"token_addresses": {
"type": "array",
"items": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$"
},
"maxItems": 50,
"description": "ERC-20 token contract addresses to read beyond the fixed list of the top 200 Base tokens.",
"uniqueItems": true
}
},
"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.",
"additionalProperties": false
},
"type": {
"type": "string",
"const": "http"
},
"method": {
"enum": [
"POST",
"PUT",
"PATCH"
],
"type": "string"
},
"bodyType": {
"enum": [
"json",
"form-data",
"text"
],
"type": "string"
}
},
"additionalProperties": false
},
"output": {
"type": "object",
"required": [
"type"
],
"properties": {
"type": {
"type": "string"
},
"example": {
"type": "object",
"required": [
"block_number",
"pagination",
"data"
],
"properties": {
"data": {
"type": "array",
"items": {
"type": "object",
"required": [
"chain",
"address",
"token_address",
"token_symbol",
"token_amount",
"token_amount_raw"
],
"properties": {
"chain": {
"type": "string"
},
"address": {
"type": "string"
},
"token_name": {
"type": "string"
},
"token_amount": {
"type": "number"
},
"token_symbol": {
"type": "string"
},
"token_address": {
"type": "string"
},
"token_decimals": {
"type": "integer"
},
"token_amount_raw": {
"type": "string",
"description": "The exact balance in the token's smallest unit."
}
}
},
"description": "Non-zero balances: native ETH first (token_address is the zero address), then tokens by the list's rank, then caller-supplied tokens."
},
"pagination": {
"type": "object",
"required": [
"page",
"per_page",
"is_last_page"
],
"properties": {
"page": {
"type": "integer"
},
"per_page": {
"type": "integer"
},
"is_last_page": {
"type": "boolean"
}
}
},
"block_number": {
"type": "integer",
"description": "The Base block every balance was read at."
}
}
}
}
}
}
}
}
}Provenance
- Seen in the source catalog
- 2026-10-26 11:36Z
- Last indexed by Roundhouse
- 2026-10-26 20:00Z
- Last enriched (probe, favicon, geo)
- 2026-10-24 15:46Z
- x402 version
- 2
- Max timeout
- 300s
- Liveness probe
- HTTP 402
Hand this page to an agent
Copy the prompt and paste it into Claude, an MCP client or your own agent — it will vet this service and call it over the free read API. No key, no account.
GET api.roundhouseai.io/v0/endpoints
No per-endpoint history for this service yet, so this is payments indexed to its PROVIDER's wallet over 30 days. Verified volume counts only settlements with an on-chain EIP-3009 marker.
Show the promptHide the prompt
Using Roundhouse, look up the x402 service Base wallet balances and tell me whether it is worth paying: what a call costs, whether the endpoint answered when last probed, and what its payment record actually shows. curl -s 'https://api.roundhouseai.io/v0/endpoints?q=Base%20wallet%20balances' curl -s 'https://api.roundhouseai.io/v0/merchants/<the payTo wallet returned above>' Then call it: read the price from the live 402 at https://api.botx402.io/base-address-balance, never from a cached figure, and pay with an x402 client. The /v0 API needs an API key (`authorization: Bearer rh_live_…`) on everything except /v0/unified* and /v0/endpoints. Either pay over x402 (mint a personal key for $0.01 at GET https://api.roundhouseai.io/v0/test/x402), or ask me for an organization key, which I create at https://roundhouseai.io/dashboard/connections. If you have neither, ask before going further. If you do not have Roundhouse tools or skills installed, read https://roundhouseai.io/skill.md first — it is the whole procedure.