Read an ERC20 token contract on Base, Ethereum or IOTA EVM mainnet: name, symbol, decim…
Read an ERC20 token contract on Base, Ethereum or IOTA EVM mainnet: name, symbol, decimals, total supply, and optionally the balance of one holder address. Verifies that the address is a contract. Params: token (contract address, required), chain ('base' defa…
by agentsvc.io · discovered, not yet claimed by its owner · updated 2026-10-11
Mirrored from Coinbase's public x402 Bazaar. The description is the provider's own text and has not been reviewed here; the payment requirements are copied as published.
What it does
Read an ERC20 token contract on Base, Ethereum or IOTA EVM mainnet: name, symbol, decimals, total supply, and optionally the balance of one holder address. Verifies that the address is a contract. Params: token (contract address, required), chain ('base' default, 'ethereum' or 'iota-evm'), holder (optional address).
Tags: erc20 · token · base · ethereum · onchain · bazaar · builder-code
Call contract
- Method
- POST
- Input
- json
- Output
- json
- Last paid call
- 2026-10-11
{
"chain": "base",
"holder": "0x622efA6Ceb83a5b6EdBC931332f4db68B7f74F27",
"token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
}{
"data": {
"chain": "base",
"chain_id": 8453,
"checked_at": "2026-10-06T12:00:00.000Z",
"decimals": 6,
"explorer": "https://basescan.org/token/0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"holder": {
"address": "0x622efA6Ceb83a5b6EdBC931332f4db68B7f74F27",
"balance": "0.009",
"balance_raw": "9000"
},
"name": "USD Coin",
"symbol": "USDC",
"token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"total_supply": "4422012871.202378",
"total_supply_raw": "4422012871202378"
},
"success": true
}Use with an agent
- Discover. Agents find this listing with
GET https://bazaar.saylorinnovations.com/discovery/search?query=…, the MCP toolsearch_resources, or/discovery/resources. - Inspect. Fetch
/resources/35656.jsonfor the price and payment options. - Pay. Call
GET https://agentsvc.io/api/v1/proxy/erc20-info. The provider answers402with its payment requirements. An x402 client signs one of the options below and retries withPAYMENT-SIGNATURE. - Execute. The provider returns
200with the data. Agent Bazaar is not in the request path and never sees your payment.
For humans
You don't need an account or an API key; you need a wallet holding a small amount of USDC on Base, Solana, Polygon, Arbitrum One, and an x402-capable client (see the examples below). Call the endpoint unpaid first to see exactly what it asks for.
Pricing & payment
- Price
- $0.0045 / request
- Protocol
- x402 v2
- Auth
- No account or API key. Pay per request.
- Networks
- Base, Solana, Polygon, Arbitrum One
- Demand
- 12 calls · 3 unique payers in 30d (public x402 Bazaar data)
x402 payment requirements
| Scheme | Network | Asset | Amount | Pay to | Timeout |
|---|---|---|---|---|---|
| exact | Base eip155:8453 | USDC | $0.0045 | 0x622efA6Ceb83a5b6EdBC931332f4db68B7f74F27 | 300s |
| exact | Solana solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp | USDC | $0.0045 | 5JzPS5qpEwUM1vTC9GG7uqvwJdHzbEwfoPHf2Ki977tg | 300s |
| exact | Polygon eip155:137 | USDC | $0.0045 | 0x622efA6Ceb83a5b6EdBC931332f4db68B7f74F27 | 300s |
| exact | Arbitrum One eip155:42161 | USDC | $0.0045 | 0x622efA6Ceb83a5b6EdBC931332f4db68B7f74F27 | 300s |
accepts[] (raw JSON)
[
{
"scheme": "exact",
"network": "eip155:8453",
"payTo": "0x622efA6Ceb83a5b6EdBC931332f4db68B7f74F27",
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"amount": "4500",
"amountUsd": 0.0045,
"maxTimeoutSeconds": 300
},
{
"scheme": "exact",
"network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
"payTo": "5JzPS5qpEwUM1vTC9GG7uqvwJdHzbEwfoPHf2Ki977tg",
"asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"amount": "4500",
"amountUsd": 0.0045,
"maxTimeoutSeconds": 300
},
{
"scheme": "exact",
"network": "eip155:137",
"payTo": "0x622efA6Ceb83a5b6EdBC931332f4db68B7f74F27",
"asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
"amount": "4500",
"amountUsd": 0.0045,
"maxTimeoutSeconds": 300
},
{
"scheme": "exact",
"network": "eip155:42161",
"payTo": "0x622efA6Ceb83a5b6EdBC931332f4db68B7f74F27",
"asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
"amount": "4500",
"amountUsd": 0.0045,
"maxTimeoutSeconds": 300
}
]Schemas
Output schema (JSON Schema)
{
"properties": {
"example": {
"properties": {
"data": {
"properties": {
"chain": {
"type": "string"
},
"chain_id": {
"type": "integer"
},
"checked_at": {
"format": "date-time",
"type": "string"
},
"decimals": {
"type": [
"integer",
"null"
]
},
"explorer": {
"type": "string"
},
"holder": {
"properties": {
"address": {
"type": "string"
},
"balance": {
"type": "string"
},
"balance_raw": {
"type": "string"
}
},
"type": [
"object",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"symbol": {
"type": [
"string",
"null"
]
},
"token": {
"type": "string"
},
"total_supply": {
"type": [
"string",
"null"
]
},
"total_supply_raw": {
"type": [
"string",
"null"
]
}
},
"required": [
"chain",
"token",
"symbol",
"decimals"
],
"type": "object"
},
"success": {
"type": "boolean"
}
},
"required": [
"success",
"data"
],
"type": "object"
},
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}Example shape — generated from the schema, not a captured live response
{
"example": {
"data": {
"chain": "string",
"chain_id": 0,
"checked_at": "2026-01-01T00:00:00Z",
"decimals": 0,
"explorer": "string",
"holder": {
"address": "string",
"balance": "string",
"balance_raw": "string"
},
"name": "string",
"symbol": "string",
"token": "string",
"total_supply": "string",
"total_supply_raw": "string"
},
"success": true
},
"type": "string"
}Examples
curl "https://agentsvc.io/api/v1/proxy/erc20-info"
# -> 402 Payment Required, accepts[] lists how to pay
# retry with a PAYMENT-SIGNATURE (or PAYMENT header) once paidconst res = await fetch("https://agentsvc.io/api/v1/proxy/erc20-info");
if (res.status === 402) {
const { accepts } = await res.json();
// pay one of accepts[] via an x402 client, then retry with the payment header
}import httpx
res = httpx.get("https://agentsvc.io/api/v1/proxy/erc20-info")
if res.status_code == 402:
accepts = res.json()["accepts"]
# pay one of accepts[] via an x402 client, then retry with the payment headerDetails
- Provider
- agentsvc.io
- Endpoint
- https://agentsvc.io/api/v1/proxy/erc20-info
- Machine-readable
/resources/35656.json