Use when you need the ERC20 token balance or wallet balance of an address on Bas
Use when you need the ERC20 token balance or wallet balance of an address on Base for onchain data checks. Do not use for ethereum mainnet or other chains, NFTs, transaction history or USD values. Returns JSON with the ETH and ERC20 token balances of a wallet on Base, read on-chain in one block: 21 major tokens plus any you list for 0.004 USDC per call. Typical response time 1200 ms (p95). Category: Data.
Answeringour last check, 2026-10-18
1 of 1checks answered this week
1270 msmedian answer time
$0.004listed price per call
$0.004price 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
POST https://x402-gateway.blackwoodstate8.workers.dev/v1/wallet-balances
| Category | Market data |
|---|---|
| Provider host | x402-gateway.blackwoodstate8.workers.dev |
| Networks | eip155:8453 |
| Payment schemes | exact, upto |
| Self-reported calls, 30 days | 4 from 1 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.004 | 1270 ms |
Example input (from the provider)
{
"body": {
"address": "0x5A6c77758820182484EA8DE614FC65423E80749a"
},
"bodyType": "json",
"method": "POST",
"type": "http"
}
Promised output schema (from the provider)
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"input": {
"additionalProperties": false,
"properties": {
"body": {
"properties": {
"address": {
"description": "Wallet address on Base, e.g. 0x5A6c77758820182484EA8DE614FC65423E80749a",
"pattern": "^0x[0-9a-fA-F]{40}$",
"type": "string"
},
"includeZero": {
"description": "Also list tokens with zero balance (false when omitted)",
"type": "boolean"
},
"tokens": {
"description": "Extra ERC20 token addresses on Base to check, e.g. [\"0x4200000000000000000000000000000000000006\"] (up to 20, beyond the 21 major ones)",
"items": {
"pattern": "^0x[0-9a-fA-F]{40}$",
"type": "string"
},
"maxItems": 20,
"type": "array"
}
},
"required": [
"address"
],
"type": "object"
},
"bodyType": {
"enum": [
"json",
"form-data",
"text"
],
"type": "string"
},
"method": {
"enum": [
"POST"
],
"type": "string"
},
"type": {
"const": "http",
"type": "string"
}
},
"required": [
"type",
"method",
"bodyType",
"body"
],
"type": "object"
},
"output": {
"properties": {
"example": {
"additionalProperties": false,
"properties": {
"address": {
"type": "string"
},
"blockNumber": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"checkedTokens": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"native": {
"additionalProperties": false,
"properties": {
"balance": {
"type": "string"
},
"raw": {
"type": "string"
},
"symbol": {
"const": "ETH",
"type": "string"
}
},
"required": [
"symbol",
"balance",
"raw"
],
"type": "object"
},
"network": {
"const": "eip155:8453",
"type": "string"
},
"next": {
"additionalProperties": false,
"description": "Suggested next paid call in the same family (call it in a loop when the task continues)",
"properties": {
"method": {
"enum": [
"GET",
"POST"
],
"type": "string"
},
"sample": {
"description": "Free fixed sample of the whole family",
"type": "string"
},
"service": {
"description": "Service id of the suggested next paid call",
"type": "string"
},
"tool": {
"description": "MCP tool name of the same call",
"type": "string"
},
"url": {
"description": "Paid route of the next call",
"type": "string"
},
"useWhen": {
"description": "When the next call is the right one",
"type": "string"
}
},
"required": [
"service",
"tool",
"method",
"url",
"useWhen",
"sample"
],
"type": "object"
},
"notTokens": {
"items": {
"type": "string"
},
"type": "array"
},
"tokens": {
"items": {
"additionalProperties": false,
"properties": {
"balance": {
"type": "string"
},
"decimals": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"raw": {
"type": "string"
},
"symbol": {
"type": [
"string",
"null"
]
},
"token": {
"type": "string"
}
},
"required": [
"token",
"symbol",
"decimals",
"balance",
"raw"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"address",
"network",
"blockNumber",
"native",
"tokens",
"notTokens",
"checkedTokens"
],
"type": "object"
},
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
},
"required": [
"input"
],
"type": "object"
}