{"slug":"agentshelf-syntexa-ch-v1-eth-erc20-balance-537baf","title":"Call when an agent needs an Ethereum mainnet ERC-20 token balance_raw and human ","host":"agentshelf.syntexa.ch","method":"POST","resource":"https://agentshelf.syntexa.ch/v1/eth-erc20-balance","category":"code","description":"Call when an agent needs an Ethereum mainnet ERC-20 token balance_raw and human balance for token and owner. Example token is Circle USDC. decimals() scales the human balance. Read-only on eip155:1. No spend. Send JSON {\"token\":\"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48\",\"owner\":\"0xd8dA6BF26964aF9D","price_listed":0.001,"price_asked":null,"state":"effects","state_label":"Not tested: has real-world effects","checks_7d":0,"answered_7d":0,"latency_ms_median":null,"reported_calls_30d":1,"reported_payers_30d":1,"networks":["eip155:8453"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"body":{"owner":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045","token":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"},"bodyType":"json","method":"POST","type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"additionalProperties":false,"examples":[{"owner":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045","token":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"}],"properties":{"owner":{"description":"Wallet whose token balance is read on Ethereum mainnet. Example: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045. Returns balance_raw and a human balance from decimals().","examples":["0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"],"type":"string"},"token":{"description":"ERC-20 contract on Ethereum mainnet. Example: 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 (Circle USDC). EIP-55 or all one case. Paired with owner.","examples":["0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"],"type":"string"}},"required":["token","owner"],"type":"object"},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"method":{"enum":["POST"],"type":"string"},"type":{"const":"http","type":"string"}},"required":["type","method","bodyType","body"],"type":"object"},"output":{"properties":{"example":{"additionalProperties":false,"examples":[{"balance":"1","balance_raw":"1000000","billed":true,"decimals":6,"network":"eip155:1","ok":true,"owner":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045","receipt_id":"rcpt_01EXAMPLE000000000000000","token":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48","warnings":[]}],"properties":{"balance":{"examples":["1"],"type":["string","null"]},"balance_raw":{"examples":["1000000"],"type":"string"},"billed":{"examples":[true],"type":"boolean"},"decimals":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"examples":[6]},"network":{"const":"eip155:1","examples":["eip155:1"],"type":"string"},"ok":{"const":true,"examples":[true],"type":"boolean"},"owner":{"examples":["0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"],"type":"string"},"receipt_id":{"examples":["rcpt_01EXAMPLE000000000000000"],"type":"string"},"token":{"examples":["0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"],"type":"string"},"warnings":{"default":[],"examples":[[]],"items":{"type":"string"},"type":"array"}},"required":["ok","receipt_id","billed","token","owner","network","decimals","balance_raw","balance"],"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"},"history":[],"description_full":"Call when an agent needs an Ethereum mainnet ERC-20 token balance_raw and human balance for token and owner. Example token is Circle USDC. decimals() scales the human balance. Read-only on eip155:1. No spend. Send JSON {\"token\":\"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48\",\"owner\":\"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045\"}. Exact $0.001 USDC on Base. Try unpaid POST /v1/sandbox/eth-erc20-balance first.","last_updated":"2026-10-17T09:30:31.107Z","schemes":["exact"]}