{"slug":"agentshelf-syntexa-ch-v1-eth-erc1155-balance-44a329","title":"Call when an agent needs ERC-1155 balances for one Ethereum wallet and up to 20 ","host":"agentshelf.syntexa.ch","method":"POST","resource":"https://agentshelf.syntexa.ch/v1/eth-erc1155-balance","category":"code","description":"Call when an agent needs ERC-1155 balances for one Ethereum wallet and up to 20 token ids via balanceOfBatch. Send contract, owner, and comma-separated token_ids. Example: The Memes by 6529 ids 132 and 538. Read-only. No spend. Send JSON {\"contract\":\"0x33FD426905F149f8376e227d0C9D3340AaD17aF1\",\"owne","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":{"contract":"0x33FD426905F149f8376e227d0C9D3340AaD17aF1","owner":"0xd0B53c871a4C2AB5DB77Ad752aA950F781021982","token_ids":"132,538"},"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":[{"contract":"0x33FD426905F149f8376e227d0C9D3340AaD17aF1","owner":"0xd0B53c871a4C2AB5DB77Ad752aA950F781021982","token_ids":"132,538"}],"properties":{"contract":{"description":"ERC-1155 contract on Ethereum mainnet. Example: 0x33FD426905F149f8376e227d0C9D3340AaD17aF1. EIP-55 or all one case. balanceOfBatch is read-only.","examples":["0x33FD426905F149f8376e227d0C9D3340AaD17aF1"],"type":"string"},"owner":{"description":"Wallet whose balances are read. Example: 0xd0B53c871a4C2AB5DB77Ad752aA950F781021982. EIP-55 or all one case. Sent as the account in balanceOf and balanceOfBatch.","examples":["0xd0B53c871a4C2AB5DB77Ad752aA950F781021982"],"type":"string"},"token_ids":{"description":"Comma-separated ERC-1155 ids, 1 to 20. Example: 132,538. One id is balanceOf; several ids are balanceOfBatch. A JSON number is not an array.","examples":["132,538"],"type":"string"}},"required":["contract","owner","token_ids"],"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":[{"balances":[{"balance_raw":"2","token_id":"132"},{"balance_raw":"1","token_id":"538"}],"billed":true,"contract":"0x33FD426905F149f8376e227d0C9D3340AaD17aF1","network":"eip155:1","ok":true,"owner":"0xd0B53c871a4C2AB5DB77Ad752aA950F781021982","receipt_id":"rcpt_01EXAMPLE000000000000000","warnings":[]}],"properties":{"balances":{"examples":[[{"balance_raw":"2","token_id":"132"},{"balance_raw":"1","token_id":"538"}]],"items":{"additionalProperties":false,"properties":{"balance_raw":{"type":"string"},"token_id":{"type":"string"}},"required":["token_id","balance_raw"],"type":"object"},"maxItems":20,"type":"array"},"billed":{"examples":[true],"type":"boolean"},"contract":{"examples":["0x33FD426905F149f8376e227d0C9D3340AaD17aF1"],"type":"string"},"network":{"const":"eip155:1","examples":["eip155:1"],"type":"string"},"ok":{"const":true,"examples":[true],"type":"boolean"},"owner":{"examples":["0xd0B53c871a4C2AB5DB77Ad752aA950F781021982"],"type":"string"},"receipt_id":{"examples":["rcpt_01EXAMPLE000000000000000"],"type":"string"},"warnings":{"default":[],"examples":[[]],"items":{"type":"string"},"type":"array"}},"required":["ok","receipt_id","billed","network","contract","owner","balances"],"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"},"history":[],"description_full":"Call when an agent needs ERC-1155 balances for one Ethereum wallet and up to 20 token ids via balanceOfBatch. Send contract, owner, and comma-separated token_ids. Example: The Memes by 6529 ids 132 and 538. Read-only. No spend. Send JSON {\"contract\":\"0x33FD426905F149f8376e227d0C9D3340AaD17aF1\",\"owner\":\"0xd0B53c871a4C2AB5DB77Ad752aA950F781021982\",\"token_ids\":\"132,538\"}. Exact $0.003 USDC on Base. Try unpaid POST /v1/sandbox/eth-erc1155-balance first.","last_updated":"2026-10-22T07:20:46.475Z","schemes":["exact"]}