{ "x402Version": 2, "id": 34841, "slug": "34841", "resource": "https://1gateway.dev/v1/onchain/base/balances", "description": "Use when an agent needs what a Base address holds in one call instead of one RPC call per token. Input: address; optional tokens (up to 20 ERC-20 addresses, comma-separated; default USDC, EURC, USDbC, WETH, cbBTC, cbETH, wstETH). Output: JSON block+time, ETH balance, per-token symbol, decimals, raw and decimal balance, nonce, isContract. Chain state only, no prices. Bad input: 400, not charged. Example: ?address=0x6246eee0355Dd7A93C888fE59e1151388A0cC5a1", "type": "http", "serviceName": "1gateway", "iconUrl": "https://res.cloudinary.com/bdb-prod/image/upload/c_fill,ar_1:1,w_256,h_256,f_auto,q_auto/v1791609992/bazaar-icons/c4d9db8f8f483844.png", "resourceType": "Beauty & Personal Care", "accepts": [ { "scheme": "exact", "network": "eip155:8453", "payTo": "0x6246eee0355Dd7A93C888fE59e1151388A0cC5a1", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "amount": "2000", "amountUsd": 0.002, "maxTimeoutSeconds": 300 } ], "outputSchema": { "properties": { "example": { "properties": { "address": { "type": "string" }, "block": { "properties": { "number": { "type": "integer" }, "timestamp": { "type": "string" } }, "type": "object" }, "chain": { "type": "string" }, "chainId": { "type": "integer" }, "codeSize": { "type": "integer" }, "eth": { "properties": { "balance": { "type": "number" }, "wei": { "type": "string" } }, "type": "object" }, "isContract": { "type": "boolean" }, "nonZeroTokens": { "type": "integer" }, "note": { "type": "string" }, "rpc": { "properties": { "kind": { "type": "string" }, "source": { "type": "string" } }, "type": "object" }, "tokenSet": { "type": "string" }, "tokens": { "items": { "properties": { "address": { "type": "string" }, "balance": { "type": [ "number", "null" ] }, "decimals": { "type": [ "integer", "null" ] }, "issuer": { "type": [ "string", "null" ] }, "raw": { "type": [ "string", "null" ] }, "status": { "type": "string" }, "symbol": { "type": [ "string", "null" ] } }, "type": "object" }, "type": "array" }, "transactionCount": { "type": "integer" } }, "required": [ "chain", "chainId", "address", "block", "isContract", "codeSize", "transactionCount", "eth", "tokenSet", "tokens", "nonZeroTokens", "rpc", "note" ], "type": "object" }, "type": { "type": "string" } }, "required": [ "type" ], "type": "object" }, "extensions": { "bazaar": { "info": { "input": { "method": "GET", "queryParams": { "address": "0x6246eee0355Dd7A93C888fE59e1151388A0cC5a1", "tokens": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913,0x4200000000000000000000000000000000000006" }, "type": "http" }, "output": { "example": { "address": "0x6246eee0355Dd7A93C888fE59e1151388A0cC5a1", "block": { "number": 52515381, "timestamp": "2026-10-12T15:48:29.000Z" }, "chain": "base", "chainId": 8453, "codeSize": 0, "eth": { "balance": 0.016974638846759017, "wei": "16974638846759016" }, "isContract": false, "nonZeroTokens": 1, "note": "Balances are raw chain state at the stated block. No prices, no USD values. The default token set is a short curated list; pass tokens= to check others.", "rpc": { "kind": "public", "source": "base-rpc.publicnode.com" }, "tokenSet": "default", "tokens": [ { "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "balance": 0.5179, "decimals": 6, "issuer": "Circle", "raw": "517900", "status": "ok", "symbol": "USDC" } ], "transactionCount": 7 }, "type": "json" } }, "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "input": { "additionalProperties": false, "properties": { "method": { "enum": [ "GET" ], "type": "string" }, "queryParams": { "additionalProperties": false, "properties": { "address": { "description": "Wallet or contract on Base mainnet (0x + 40 hex; mixed case must be a valid EIP-55 checksum). Bad input → 400 (not charged)", "examples": [ "0x6246eee0355Dd7A93C888fE59e1151388A0cC5a1" ], "pattern": "^0x[0-9a-fA-F]{40}$", "type": "string" }, "tokens": { "description": "Up to 20 comma-separated ERC-20 contract addresses on Base. Omit for the default set. A contract that is not an ERC-20 is listed with status not_an_erc20.", "examples": [ "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913,0x4200000000000000000000000000000000000006" ], "maxLength": 900, "type": "string" } }, "required": [ "address" ], "type": "object" }, "type": { "const": "http", "type": "string" } }, "required": [ "type", "method" ], "type": "object" }, "output": { "properties": { "example": { "properties": { "address": { "type": "string" }, "block": { "properties": { "number": { "type": "integer" }, "timestamp": { "type": "string" } }, "type": "object" }, "chain": { "type": "string" }, "chainId": { "type": "integer" }, "codeSize": { "type": "integer" }, "eth": { "properties": { "balance": { "type": "number" }, "wei": { "type": "string" } }, "type": "object" }, "isContract": { "type": "boolean" }, "nonZeroTokens": { "type": "integer" }, "note": { "type": "string" }, "rpc": { "properties": { "kind": { "type": "string" }, "source": { "type": "string" } }, "type": "object" }, "tokenSet": { "type": "string" }, "tokens": { "items": { "properties": { "address": { "type": "string" }, "balance": { "type": [ "number", "null" ] }, "decimals": { "type": [ "integer", "null" ] }, "issuer": { "type": [ "string", "null" ] }, "raw": { "type": [ "string", "null" ] }, "status": { "type": "string" }, "symbol": { "type": [ "string", "null" ] } }, "type": "object" }, "type": "array" }, "transactionCount": { "type": "integer" } }, "required": [ "chain", "chainId", "address", "block", "isContract", "codeSize", "transactionCount", "eth", "tokenSet", "tokens", "nonZeroTokens", "rpc", "note" ], "type": "object" }, "type": { "type": "string" } }, "required": [ "type" ], "type": "object" } }, "required": [ "input" ], "type": "object" } } }, "tags": [ "base", "wallet-balance", "erc20", "onchain", "portfolio", "bazaar" ], "sourceHost": "1gateway.dev", "lastUpdated": "2026-10-12T23:46:39.727Z", "quality": { "calls30d": 2, "uniquePayers30d": 2, "lastCalledAt": "2026-10-12T23:46:39.473Z" }, "metadata": { "serviceName": "1gateway", "iconUrl": "https://res.cloudinary.com/bdb-prod/image/upload/c_fill,ar_1:1,w_256,h_256,f_auto,q_auto/v1791609992/bazaar-icons/c4d9db8f8f483844.png", "extensions": { "bazaar": { "info": { "input": { "method": "GET", "queryParams": { "address": "0x6246eee0355Dd7A93C888fE59e1151388A0cC5a1", "tokens": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913,0x4200000000000000000000000000000000000006" }, "type": "http" }, "output": { "example": { "address": "0x6246eee0355Dd7A93C888fE59e1151388A0cC5a1", "block": { "number": 52515381, "timestamp": "2026-10-12T15:48:29.000Z" }, "chain": "base", "chainId": 8453, "codeSize": 0, "eth": { "balance": 0.016974638846759017, "wei": "16974638846759016" }, "isContract": false, "nonZeroTokens": 1, "note": "Balances are raw chain state at the stated block. No prices, no USD values. The default token set is a short curated list; pass tokens= to check others.", "rpc": { "kind": "public", "source": "base-rpc.publicnode.com" }, "tokenSet": "default", "tokens": [ { "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "balance": 0.5179, "decimals": 6, "issuer": "Circle", "raw": "517900", "status": "ok", "symbol": "USDC" } ], "transactionCount": 7 }, "type": "json" } }, "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "input": { "additionalProperties": false, "properties": { "method": { "enum": [ "GET" ], "type": "string" }, "queryParams": { "additionalProperties": false, "properties": { "address": { "description": "Wallet or contract on Base mainnet (0x + 40 hex; mixed case must be a valid EIP-55 checksum). Bad input → 400 (not charged)", "examples": [ "0x6246eee0355Dd7A93C888fE59e1151388A0cC5a1" ], "pattern": "^0x[0-9a-fA-F]{40}$", "type": "string" }, "tokens": { "description": "Up to 20 comma-separated ERC-20 contract addresses on Base. Omit for the default set. A contract that is not an ERC-20 is listed with status not_an_erc20.", "examples": [ "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913,0x4200000000000000000000000000000000000006" ], "maxLength": 900, "type": "string" } }, "required": [ "address" ], "type": "object" }, "type": { "const": "http", "type": "string" } }, "required": [ "type", "method" ], "type": "object" }, "output": { "properties": { "example": { "properties": { "address": { "type": "string" }, "block": { "properties": { "number": { "type": "integer" }, "timestamp": { "type": "string" } }, "type": "object" }, "chain": { "type": "string" }, "chainId": { "type": "integer" }, "codeSize": { "type": "integer" }, "eth": { "properties": { "balance": { "type": "number" }, "wei": { "type": "string" } }, "type": "object" }, "isContract": { "type": "boolean" }, "nonZeroTokens": { "type": "integer" }, "note": { "type": "string" }, "rpc": { "properties": { "kind": { "type": "string" }, "source": { "type": "string" } }, "type": "object" }, "tokenSet": { "type": "string" }, "tokens": { "items": { "properties": { "address": { "type": "string" }, "balance": { "type": [ "number", "null" ] }, "decimals": { "type": [ "integer", "null" ] }, "issuer": { "type": [ "string", "null" ] }, "raw": { "type": [ "string", "null" ] }, "status": { "type": "string" }, "symbol": { "type": [ "string", "null" ] } }, "type": "object" }, "type": "array" }, "transactionCount": { "type": "integer" } }, "required": [ "chain", "chainId", "address", "block", "isContract", "codeSize", "transactionCount", "eth", "tokenSet", "tokens", "nonZeroTokens", "rpc", "note" ], "type": "object" }, "type": { "type": "string" } }, "required": [ "type" ], "type": "object" } }, "required": [ "input" ], "type": "object" } } } }, "liveness": { "reliability": null }, "verified": false, "featured": false, "provider": { "host": "1gateway.dev", "manifest_name": "1gateway.dev", "source": "cdp-mirror", "source_manifest_url": "https://api.cdp.coinbase.com/platform/v2/x402/discovery/resources", "submitted_at": "2026-10-14T01:15:01.050Z" }, "exampleResponse": { "example": { "address": "string", "block": { "number": 0, "timestamp": "string" }, "chain": "string", "chainId": 0, "codeSize": 0, "eth": { "balance": 0, "wei": "string" }, "isContract": true, "nonZeroTokens": 0, "note": "string", "rpc": { "kind": "string", "source": "string" }, "tokenSet": "string", "tokens": [ { "address": "string", "balance": 0, "decimals": 0, "issuer": "string", "raw": "string", "status": "string", "symbol": "string" } ], "transactionCount": 0 }, "type": "string" } }