Read an ERC-20 token balance on Base
Read an ERC-20 token balance on Base. POST {"address":"0x...","token":"0x..."} and receive the raw balance, the token decimals and the human-readable amount. Defaults to USDC when token is omitted. Live chain state, no indexer lag.
Answeringour last check, 2026-09-24
1 of 1checks answered this week
231 msmedian answer time
$0.001listed price per call
$0.001price 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-echo-service.onrender.com/chain/erc20-balance
| Category | Market data |
|---|---|
| Provider host | x402-echo-service.onrender.com |
| Networks | eip155:8453 |
| Payment schemes | exact |
| Self-reported calls, 30 days | 1 from 1 payers (the provider's figure, not ours) |
Our checks, last 30 days
| Day | Result | HTTP | Asked | Time |
|---|---|---|---|---|
| 2026-09-24 | valid payment request | 402 | $0.001 | 231 ms |
Example input (from the provider)
{
"body": {
"address": "0x9Cc774A8eD49d89cBA1A288F4a050B8F7FbA77EE"
},
"bodyType": "json",
"method": "POST",
"type": "http"
}
Promised output schema (from the provider)
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"input": {
"properties": {
"body": {
"additionalProperties": false,
"properties": {
"address": {
"description": "Account to read.",
"type": "string"
},
"token": {
"description": "ERC-20 contract. Defaults to USDC on Base.",
"type": "string"
}
},
"required": [
"address"
],
"type": "object"
},
"bodyType": {
"enum": [
"json"
]
},
"method": {
"enum": [
"POST"
],
"type": "string"
},
"type": {
"const": "http"
}
},
"required": [
"type",
"bodyType",
"body",
"method"
],
"type": "object"
},
"output": {
"properties": {
"example": {
"properties": {
"address": {
"type": "string"
},
"amount": {
"type": "string"
},
"decimals": {
"type": "integer"
},
"raw": {
"type": "string"
},
"token": {
"type": "string"
}
},
"required": [
"address",
"token",
"raw",
"decimals",
"amount"
],
"type": "object"
},
"type": {
"const": "json"
}
},
"required": [
"type",
"example"
],
"type": "object"
}
},
"required": [
"input",
"output"
],
"type": "object"
}