Wallet balance: token balances and USD portfolio value for any wallet, read live onchain
Wallet balance: token balances and USD portfolio value for any wallet, read live onchain. EVM (Ethereum, Base, Arbitrum, Polygon in one call; ENS names work) or Solana (SOL + SPL tokens). Use to check a wallet before paying, trading or airdrops. Pass address,…
by x402-seller-pmlm.onrender.com · discovered, not yet claimed by its owner · updated 2026-10-08
Mirrored from Coinbase's public x402 Bazaar. The description is the provider's own text and has not been reviewed here; the payment requirements are copied as published.
What it does
Wallet balance: token balances and USD portfolio value for any wallet, read live onchain. EVM (Ethereum, Base, Arbitrum, Polygon in one call; ENS names work) or Solana (SOL + SPL tokens). Use to check a wallet before paying, trading or airdrops. Pass address, optional chain and tokens. Returns per-chain native + ERC-20/SPL balances, prices and total USD. 0.003 USDC/call; failed calls are free.
Tags: wallet balance · erc20 balance · token balances · portfolio value · solana wallet · bazaar · builder-code · eip2612GasSponsoring · erc20ApprovalGasSponsoring
Call contract
- Method
- GET
- Input
- query parameters
- Output
- json
- Last paid call
- 2026-10-08
{
"address": "vitalik.eth"
}{
"address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
"cached": false,
"chains": [
{
"block": 26131717,
"chain": "ethereum",
"native": {
"balance": 5.753008903,
"priceUsd": 2697.7011,
"symbol": "ETH",
"usd": 15519.9
},
"tokens": [
{
"address": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
"balance": 1.465109425,
"priceUsd": 2697.7011,
"symbol": "WETH",
"usd": 3952.43
},
{
"address": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
"balance": 291.368219,
"priceSource": "stablecoin (assumed $1)",
"priceUsd": 1,
"symbol": "USDT",
"usd": 291.37
}
],
"tokensChecked": 18,
"totalUsd": 19839.17
},
{
"block": 52240416,
"chain": "base",
"native": {
"balance": 3.128821803,
"priceUsd": 2697.8033,
"symbol": "ETH",
"usd": 8440.95
},
"tokens": [
{
"address": "0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed",
"balance": 3000574.185,
"priceUsd": 0.0011,
"symbol": "DEGEN",
"usd": 3154.8
},
{
"address": "0x4200000000000000000000000000000000000006",
"balance": 0.2003812866,
"priceUsd": 2697.8033,
"symbol": "WETH",
"usd": 540.59
}
],
"tokensChecked": 11,
"totalUsd": 12192.44
},
{
"block": 512172625,
"chain": "arbitrum",
"native": {
"balance": 0.1594117609,
"priceUsd": 2696.8778,
"symbol": "ETH",
"usd": 429.91
},
"tokens": [
{
"address": "0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9",
"balance": 253.338516,
"priceSource": "stablecoin (assumed $1)",
"priceUsd": 1,
"symbol": "USD₮0",
"usd": 253.34
},
{
"address": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
"balance": 158.021811,
"priceSource": "stablecoin (assumed $1)",
"priceUsd": 1,
"symbol": "USDC",
"usd": 158.02
}
],
"tokensChecked": 9,
"totalUsd": 1005.02
},
{
"block": 95043351,
"chain": "polygon",
"native": {
"balance": 592.7197672,
"priceUsd": 0.109,
"symbol": "POL",
"usd": 64.6
},
"tokens": [
{
"address": "0xc2132D05D31c914a87C6611C10748AEb04B58e8F",
"balance": 80.720892,
"priceSource": "stablecoin (assumed $1)",
"priceUsd": 1,
"symbol": "USDT0",
"usd": 80.72
},
{
"address": "0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174",
"balance": 76.687483,
"priceSource": "stablecoin (assumed $1)",
"priceUsd": 1,
"symbol": "USDC",
"usd": 76.69
}
],
"tokensChecked": 9,
"totalUsd": 245.29
}
],
"ens": "vitalik.eth",
"generatedAt": "2026-10-06T07:03:01.443Z",
"latencyMs": 2011,
"note": "Balances read live from public RPC nodes. EVM: native coin + a curated list of major tokens per chain (add more with tokens=); Solana: SOL…",
"totalUsd": 33281.92
}Use with an agent
- Discover. Agents find this listing with
GET https://bazaar.saylorinnovations.com/discovery/search?query=…, the MCP toolsearch_resources, or/discovery/resources. - Inspect. Fetch
/resources/28416.jsonfor the price and payment options. - Pay. Call
GET https://x402-seller-pmlm.onrender.com/balance. The provider answers402with its payment requirements. An x402 client signs one of the options below and retries withPAYMENT-SIGNATURE. - Execute. The provider returns
200with the data. Agent Bazaar is not in the request path and never sees your payment.
For humans
You don't need an account or an API key; you need a wallet holding a small amount of USDC on Base, Polygon, Arbitrum One, Solana, Avalanche, eip155:1329, and an x402-capable client (see the examples below). Call the endpoint unpaid first to see exactly what it asks for.
Pricing & payment
- Price
- $0.003 / request
- Protocol
- x402 v2
- Auth
- No account or API key. Pay per request.
- Networks
- Base, Polygon, Arbitrum One, Solana, Avalanche, eip155:1329
- Demand
- 5 calls · 3 unique payers in 30d (public x402 Bazaar data)
x402 payment requirements
| Scheme | Network | Asset | Amount | Pay to | Timeout |
|---|---|---|---|---|---|
| exact | Base eip155:8453 | USDC | $0.003 | 0x079471E6F43b6feeF80895E19cBFcBB496904852 | 300s |
| exact | Polygon eip155:137 | USDC | $0.003 | 0x079471E6F43b6feeF80895E19cBFcBB496904852 | 300s |
| exact | Arbitrum One eip155:42161 | USDC | $0.003 | 0x079471E6F43b6feeF80895E19cBFcBB496904852 | 300s |
| exact | Solana solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp | USDC | $0.003 | 787RZwDGpjmRsG5wgnyBeWQHBuARax8Qo6P7dmDuqKeW | 300s |
| exact | Avalanche eip155:43114 | 0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E | 3000 | 0x079471E6F43b6feeF80895E19cBFcBB496904852 | 300s |
| exact | eip155:1329 eip155:1329 | 0xe15fC38F6D8c56aF07bbCBe3BAf5708A2Bf42392 | 3000 | 0x079471E6F43b6feeF80895E19cBFcBB496904852 | 300s |
accepts[] (raw JSON)
[
{
"scheme": "exact",
"network": "eip155:8453",
"payTo": "0x079471E6F43b6feeF80895E19cBFcBB496904852",
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"amount": "3000",
"amountUsd": 0.003,
"maxTimeoutSeconds": 300
},
{
"scheme": "exact",
"network": "eip155:137",
"payTo": "0x079471E6F43b6feeF80895E19cBFcBB496904852",
"asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
"amount": "3000",
"amountUsd": 0.003,
"maxTimeoutSeconds": 300
},
{
"scheme": "exact",
"network": "eip155:42161",
"payTo": "0x079471E6F43b6feeF80895E19cBFcBB496904852",
"asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
"amount": "3000",
"amountUsd": 0.003,
"maxTimeoutSeconds": 300
},
{
"scheme": "exact",
"network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
"payTo": "787RZwDGpjmRsG5wgnyBeWQHBuARax8Qo6P7dmDuqKeW",
"asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"amount": "3000",
"amountUsd": 0.003,
"maxTimeoutSeconds": 300
},
{
"scheme": "exact",
"network": "eip155:43114",
"payTo": "0x079471E6F43b6feeF80895E19cBFcBB496904852",
"asset": "0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E",
"amount": "3000",
"maxTimeoutSeconds": 300
},
{
"scheme": "exact",
"network": "eip155:1329",
"payTo": "0x079471E6F43b6feeF80895E19cBFcBB496904852",
"asset": "0xe15fC38F6D8c56aF07bbCBe3BAf5708A2Bf42392",
"amount": "3000",
"maxTimeoutSeconds": 300
}
]Schemas
Output schema (JSON Schema)
{
"properties": {
"example": {
"properties": {
"address": {
"type": "string"
},
"chains": {
"items": {
"properties": {
"chain": {
"type": "string"
},
"native": {
"type": "object"
},
"tokens": {
"items": {
"type": "object"
},
"type": "array"
},
"totalUsd": {
"type": "number"
}
},
"type": "object"
},
"type": "array"
},
"ens": {
"type": "string"
},
"generatedAt": {
"type": "string"
},
"totalUsd": {
"type": "number"
}
},
"required": [
"address",
"chains",
"totalUsd"
],
"type": "object"
},
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}Example shape — generated from the schema, not a captured live response
{
"example": {
"address": "string",
"chains": [
{
"chain": "string",
"native": {},
"tokens": [
{}
],
"totalUsd": 0
}
],
"ens": "string",
"generatedAt": "string",
"totalUsd": 0
},
"type": "string"
}Examples
curl "https://x402-seller-pmlm.onrender.com/balance"
# -> 402 Payment Required, accepts[] lists how to pay
# retry with a PAYMENT-SIGNATURE (or PAYMENT header) once paidconst res = await fetch("https://x402-seller-pmlm.onrender.com/balance");
if (res.status === 402) {
const { accepts } = await res.json();
// pay one of accepts[] via an x402 client, then retry with the payment header
}import httpx
res = httpx.get("https://x402-seller-pmlm.onrender.com/balance")
if res.status_code == 402:
accepts = res.json()["accepts"]
# pay one of accepts[] via an x402 client, then retry with the payment headerDetails
- Provider
- x402-seller-pmlm.onrender.com
- Endpoint
- https://x402-seller-pmlm.onrender.com/balance
- Machine-readable
/resources/28416.json