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.

TradingLiveeip155:8453Exactvia cdp
CryptoOnchainBaseWallet
Settlements · 30d
11
No per-endpoint history for this service yet, so this is payments indexed to its PROVIDER's wallet over 30 days.
$0.11
Verified settled volume
11 settlements proven x402 by their on-chain EIP-3009 marker.
$0.010
Listed price
As published in the catalog. Always read the live 402 before paying.
10
Calls · 30d
Upstream's own call count for this endpoint, not ours.
6
Unique payers · 30d
Last called 2026-10-26 11:36Z
—
Upstream on-chain volume
Reported by the source catalog.
Paid to
0x007bc3987566F3aca40adC3F36c56207E1E0c2fc

The wallet the 402 directs payment to. Its whole payment record — every payer, every chain — is on the merchant page.

Asset 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

Provider

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.

0.01USDC≈ $0.01 USD
on Base · exact scheme

Pay 0.01 USDC on Base to 0x007b…0c2fc. The signed payment is good for 5 minutes.

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
Report

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.

Open skill.md
Show 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.