{"slug":"agentshelf-syntexa-ch-v1-base-portfolio-b9ea93","title":"Call when an agent needs native ETH plus up to 20 ERC-20 balances for one Base a","host":"agentshelf.syntexa.ch","method":"POST","resource":"https://agentshelf.syntexa.ch/v1/base-portfolio","category":"code","description":"Call when an agent needs native ETH plus up to 20 ERC-20 balances for one Base 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\":[\"0x833589fCD6e","price_listed":0.005,"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":["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":[{"address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045","tokens":["0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"]}],"properties":{"address":{"description":"Holder on Base 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: [\"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913\"]. Omit the field for Circle USDC. An empty list is rejected.","examples":[["0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"]],"items":{"description":"ERC-20 contract. Example: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913. 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:8453","ok":true,"receipt_id":"rcpt_01EXAMPLE000000000000000","tokens":[{"balance":"2.5","balance_raw":"2500000","decimals":6,"ok":true,"token":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}],"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:8453","examples":["eip155:8453"],"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":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}]],"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 Base 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\":[\"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913\"]}. Exact $0.005 USDC on Base. Try unpaid POST /v1/sandbox/base-portfolio first.","last_updated":"2026-10-17T08:29:09.694Z","schemes":["exact"]}