{"slug":"agentshelf-syntexa-ch-v1-eth-portfolio-e85b3c","title":"Call when an agent needs native ETH plus up to 20 ERC-20 balances for one Ethere","host":"agentshelf.syntexa.ch","method":"POST","resource":"https://agentshelf.syntexa.ch/v1/eth-portfolio","category":"code","description":"Call when an agent needs native ETH plus up to 20 ERC-20 balances for one Ethereum address. Send address and an optional tokens list; omit tokens for Circle USDC. Multicall3 batches the reads. Read-only. No spend. Send JSON {\"address\":\"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045\",\"tokens\":[\"0xA0b8699","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":{"address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045","tokens":["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":[{"address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045","tokens":["0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"]}],"properties":{"address":{"description":"Holder on Ethereum mainnet. Example: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045. Returns native ETH plus ERC-20 balances. EIP-55 or all one case.","examples":["0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"],"type":"string"},"tokens":{"description":"Up to 20 ERC-20 addresses. Example: [\"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48\"]. Omit the field for Circle USDC. An empty list is rejected.","examples":[["0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"]],"items":{"description":"ERC-20 contract. Example: 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48. At most 20. Omit the list to use Circle USDC.","type":"string"},"maxItems":20,"type":"array"}},"required":["address"],"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":[{"address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045","billed":true,"eth_balance":"1","eth_balance_wei":"1000000000000000000","network":"eip155:1","ok":true,"receipt_id":"rcpt_01EXAMPLE000000000000000","tokens":[{"balance":"2.5","balance_raw":"2500000","decimals":6,"ok":true,"token":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"}],"used_default_tokens":false,"warnings":[]}],"properties":{"address":{"examples":["0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"],"type":"string"},"billed":{"examples":[true],"type":"boolean"},"eth_balance":{"examples":["1"],"type":"string"},"eth_balance_wei":{"examples":["1000000000000000000"],"type":"string"},"network":{"const":"eip155:1","examples":["eip155:1"],"type":"string"},"ok":{"const":true,"examples":[true],"type":"boolean"},"receipt_id":{"examples":["rcpt_01EXAMPLE000000000000000"],"type":"string"},"tokens":{"examples":[[{"balance":"2.5","balance_raw":"2500000","decimals":6,"ok":true,"token":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"}]],"items":{"additionalProperties":false,"properties":{"balance":{"type":["string","null"]},"balance_raw":{"type":["string","null"]},"decimals":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}]},"ok":{"type":"boolean"},"token":{"type":"string"}},"required":["token","decimals","balance_raw","balance","ok"],"type":"object"},"maxItems":20,"type":"array"},"used_default_tokens":{"examples":[false],"type":"boolean"},"warnings":{"default":[],"examples":[[]],"items":{"type":"string"},"type":"array"}},"required":["ok","receipt_id","billed","network","address","eth_balance_wei","eth_balance","used_default_tokens","tokens"],"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"},"history":[],"description_full":"Call when an agent needs native ETH plus up to 20 ERC-20 balances for one Ethereum address. Send address and an optional tokens list; omit tokens for Circle USDC. Multicall3 batches the reads. Read-only. No spend. Send JSON {\"address\":\"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045\",\"tokens\":[\"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48\"]}. Exact $0.003 USDC on Base. Try unpaid POST /v1/sandbox/eth-portfolio first.","last_updated":"2026-10-20T07:39:08.963Z","schemes":["exact"]}