{"slug":"agentsvc-io-api-v1-proxy-erc20-info-2b78b9","title":"Read an ERC20 token contract on Base or Ethereum mainnet","host":"agentsvc.io","method":"POST","resource":"https://agentsvc.io/api/v1/proxy/erc20-info","category":"market","description":"Read an ERC20 token contract on Base or Ethereum 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 or 'ethereum'), holder (optional address).","price_listed":0.0045,"price_asked":0.0045,"state":"answering","state_label":"Answering","checks_7d":1,"answered_7d":1,"latency_ms_median":893,"reported_calls_30d":10,"reported_payers_30d":3,"networks":["eip155:137","eip155:42161","eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"body":{"chain":"base","holder":"0x622efA6Ceb83a5b6EdBC931332f4db68B7f74F27","token":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"},"bodyType":"json","method":"POST","type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"properties":{"chain":{"default":"base","enum":["base","ethereum"],"type":"string"},"holder":{"description":"Optional address whose token balance to return","pattern":"^0x[0-9a-fA-F]{40}$","type":"string"},"token":{"description":"ERC20 contract address","pattern":"^0x[0-9a-fA-F]{40}$","type":"string"}},"required":["token"]},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"type":{"const":"http","type":"string"}},"required":["type","method","bodyType","body"],"type":"object"},"output":{"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"}},"required":["input"],"type":"object"},"history":[{"day":"2026-10-10","reachable":true,"status":402,"valid_402":true,"asked_usdc":0.0045,"price_match":true,"latency_ms":893,"error":null}],"description_full":"Read an ERC20 token contract on Base or Ethereum 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 or 'ethereum'), holder (optional address).","last_updated":"2026-10-10T09:08:31.357Z","schemes":["exact"]}