Use when an agent needs what a Base address holds in one call instead of one RPC
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
Answeringour last check, 2026-10-18
1 of 1checks answered this week
30 msmedian answer time
$0.002listed price per call
$0.002price it asked us
Paid test badge: not yet. The checks above are free: we call the tool without paying and read the payment request it sends back. The Verified badge needs paid calls whose answers match the promised output, and nobody can buy a badge.
Endpoint
GET https://1gateway.dev/v1/onchain/base/balances
| Category | Market data |
|---|---|
| Provider host | 1gateway.dev |
| Networks | eip155:8453 |
| Payment schemes | exact |
| Self-reported calls, 30 days | 2 from 2 payers (the provider's figure, not ours) |
Our checks, last 30 days
| Day | Result | HTTP | Asked | Time |
|---|---|---|---|---|
| 2026-10-18 | valid payment request | 402 | $0.002 | 30 ms |
Example input (from the provider)
{
"method": "GET",
"queryParams": {
"address": "0x6246eee0355Dd7A93C888fE59e1151388A0cC5a1",
"tokens": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913,0x4200000000000000000000000000000000000006"
},
"type": "http"
}
Promised output schema (from the provider)
{
"$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 \u2192 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"
}