{"slug":"agentshelf-syntexa-ch-v1-base-erc20-balance-fb9155","title":"Call when an agent needs an ERC-20 balance_raw and human balance for token and o","host":"agentshelf.syntexa.ch","method":"POST","resource":"https://agentshelf.syntexa.ch/v1/base-erc20-balance","category":"code","description":"Call when an agent needs an ERC-20 balance_raw and human balance for token and owner on Base. Example token is Circle USDC. decimals() scales the human balance. Distinct from base-balance (native ETH). Read-only. No spend. Send JSON {\"token\":\"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913\",\"owner\":\"0xd8","price_listed":0.003,"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":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"},"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":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}],"properties":{"owner":{"description":"Wallet whose token balance is read. Example: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045. EIP-55 or all one case. Returns balance_raw and a human balance from decimals().","examples":["0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"],"type":"string"},"token":{"description":"ERC-20 contract on Base mainnet. Example: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 (Circle USDC). EIP-55 or all one case. Paired with owner. Distinct from base-balance, which reads native ETH.","examples":["0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"],"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":"2.5","balance_raw":"2500000","billed":true,"decimals":6,"network":"eip155:8453","ok":true,"owner":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045","receipt_id":"rcpt_01EXAMPLE000000000000000","token":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","warnings":[]}],"properties":{"balance":{"examples":["2.5"],"type":["string","null"]},"balance_raw":{"examples":["2500000"],"type":"string"},"billed":{"examples":[true],"type":"boolean"},"decimals":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"examples":[6]},"network":{"const":"eip155:8453","examples":["eip155:8453"],"type":"string"},"ok":{"const":true,"examples":[true],"type":"boolean"},"owner":{"examples":["0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"],"type":"string"},"receipt_id":{"examples":["rcpt_01EXAMPLE000000000000000"],"type":"string"},"token":{"examples":["0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"],"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 ERC-20 balance_raw and human balance for token and owner on Base. Example token is Circle USDC. decimals() scales the human balance. Distinct from base-balance (native ETH). Read-only. No spend. Send JSON {\"token\":\"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913\",\"owner\":\"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045\"}. Exact $0.003 USDC on Base. Try unpaid POST /v1/sandbox/base-erc20-balance first.","last_updated":"2026-10-11T10:14:10.944Z","schemes":["exact"]}