Get ERC20 token balance for any wallet and token contract on Base (or Ethereum)
Get ERC20 token balance for any wallet and token contract on Base (or Ethereum). Returns balance, decimals, and symbol via balanceOf. Use for live ERC20 holdings checks without an API key.
1000 (raw units)
price
2
calls / 30d
2
unique payers
2026-09-09
updated
Provider
signals.edge.report · discovered, not yet claimed by its owner
Payment (x402 accepts[])
[
{
"scheme": "exact",
"network": "eip155:8453",
"payTo": "0xE2520f1497ee47645072a6214304807BC3340D58",
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"amount": "1000",
"maxTimeoutSeconds": 300
}
]Output schema
{
"bazaar": {
"info": {
"input": {
"method": "GET",
"queryParams": {
"address": "0x0000000000000000000000000000000000000001",
"chain": "base",
"token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
},
"type": "http"
},
"output": {
"example": {
"balance": "12.5",
"balanceRaw": "12500000",
"chain": "base",
"decimals": 6,
"product": "edge-signals-erc20-balance",
"symbol": "USDC",
"token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"wallet": "0x0000000000000000000000000000000000000001"
},
"type": "json"
}
},
"schema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"input": {
"additionalProperties": false,
"properties": {
"method": {
"enum": [
"GET"
],
"type": "string"
},
"queryParams": {
"properties": {
"address": {
"description": "Wallet address to read ERC20 balance for",
"type": "string"
},
"chain": {
"description": "Chain: base (default) or ethereum",
"type": "string"
},
"token": {
"description": "ERC20 token contract address",
"type": "string"
}
},
"required": [
"address",
"token"
],
"type": "object"
},
"type": {
"const": "http",
"type": "string"
}
},
"required": [
"type",
"method"
],
"type": "object"
},
"output": {
"properties": {
"example": {
"type": "object"
},
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
},
"required": [
"input"
],
"type": "object"
}
}
}Use it
curl
curl "https://signals.edge.report/v1/erc20-balance" # -> 402 Payment Required, accepts[] lists how to pay # retry with a PAYMENT-SIGNATURE (or PAYMENT header) once paid
JavaScript
const res = await fetch("https://signals.edge.report/v1/erc20-balance");
if (res.status === 402) {
const { accepts } = await res.json();
// pay one of accepts[] via an x402 client, then retry with the payment header
}Python
import httpx
res = httpx.get("https://signals.edge.report/v1/erc20-balance")
if res.status_code == 402:
accepts = res.json()["accepts"]
# pay one of accepts[] via an x402 client, then retry with the payment headerMachine-readable
Everything on this page is also available as clean JSON at /resources/5059.json, and this resource appears in /discovery/resources and /discovery/search.