ERC-20 token balance of a wallet on Optimism (USDC, USDT, WETH or any token, via
ERC-20 token balance of a wallet on Optimism (USDC, USDT, WETH or any token, via balanceOf): raw amount, decimals, symbol and the human-readable amount, live from the token contract. Use to check stablecoin or token holdings before a transfer or trade; for the native coin use op_balance. Both inputs are 0x addresses (40 hex characters); no contract returns 404 and a non-ERC-20 contract 422, both uncharged.
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://agent-data-tools.revmesh2074.workers.dev/op/token-balance
| Category | Market data |
|---|---|
| Provider host | agent-data-tools.revmesh2074.workers.dev |
| Networks | eip155:137, eip155:42161, eip155:8453, solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp |
| Payment schemes | exact |
| Self-reported calls, 30 days | 3 from 2 payers (the provider's figure, not ours) |
Our checks, last 30 days
We never call tools that send, buy, move money or file anything, not even without paying.
Example input (from the provider)
{
"method": "GET",
"queryParams": {
"address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
"token": "0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85"
},
"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": {
"properties": {
"address": {
"description": "0x wallet address",
"examples": [
"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
],
"pattern": "^0x[0-9a-fA-F]{40}$",
"type": "string"
},
"token": {
"description": "Token: a ticker such as USDC, USDT, WETH or DAI, or the 0x ERC-20 contract address",
"examples": [
"0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85"
],
"pattern": "^0x[0-9a-fA-F]{40}$",
"type": "string"
}
},
"required": [
"token",
"address"
],
"type": "object"
},
"type": {
"const": "http",
"type": "string"
}
},
"required": [
"type",
"method"
],
"type": "object"
},
"output": {
"properties": {
"example": {
"properties": {
"address": {
"type": "string"
},
"balance": {
"type": "string"
},
"chain": {
"type": "string"
},
"chainId": {
"type": "number"
},
"decimals": {
"type": "number"
},
"raw": {
"type": "string"
},
"symbol": {
"type": "string"
},
"token": {
"type": "string"
}
},
"type": "object"
},
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
},
"required": [
"input"
],
"type": "object"
}