{"slug":"agentshelf-syntexa-ch-v1-base-erc1155-balance-efd83f","title":"Call when an agent needs ERC-1155 balances for one Base wallet and up to 20 toke","host":"agentshelf.syntexa.ch","method":"POST","resource":"https://agentshelf.syntexa.ch/v1/base-erc1155-balance","category":"code","description":"Call when an agent needs ERC-1155 balances for one Base wallet and up to 20 token ids via balanceOfBatch. Send contract, owner, and comma-separated token_ids. Example: Basepaint 1168 and 1169. Read-only. No spend. Send JSON {\"contract\":\"0xBa5e05cb26b78eDa3A2f8e3b3814726305dcAc83\",\"owner\":\"0x8BA0D770","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":"0xBa5e05cb26b78eDa3A2f8e3b3814726305dcAc83","owner":"0x8BA0D7704dF6a610F4ce9937d31E0Bbc19717311","token_ids":"1168,1169"},"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":"0xBa5e05cb26b78eDa3A2f8e3b3814726305dcAc83","owner":"0x8BA0D7704dF6a610F4ce9937d31E0Bbc19717311","token_ids":"1168,1169"}],"properties":{"contract":{"description":"ERC-1155 contract on Base mainnet. Example: 0xBa5e05cb26b78eDa3A2f8e3b3814726305dcAc83. EIP-55 or all one case. balanceOfBatch is read-only.","examples":["0xBa5e05cb26b78eDa3A2f8e3b3814726305dcAc83"],"type":"string"},"owner":{"description":"Wallet whose balances are read. Example: 0x8BA0D7704dF6a610F4ce9937d31E0Bbc19717311. EIP-55 or all one case. Sent as the account in balanceOf and balanceOfBatch.","examples":["0x8BA0D7704dF6a610F4ce9937d31E0Bbc19717311"],"type":"string"},"token_ids":{"description":"Comma-separated ERC-1155 ids, 1 to 20. Example: 1168,1169. One id is balanceOf; several ids are balanceOfBatch. A JSON number is not an array.","examples":["1168,1169"],"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":"1168"},{"balance_raw":"2","token_id":"1169"}],"billed":true,"contract":"0xBa5e05cb26b78eDa3A2f8e3b3814726305dcAc83","network":"eip155:8453","ok":true,"owner":"0x8BA0D7704dF6a610F4ce9937d31E0Bbc19717311","receipt_id":"rcpt_01EXAMPLE000000000000000","warnings":[]}],"properties":{"balances":{"examples":[[{"balance_raw":"2","token_id":"1168"},{"balance_raw":"2","token_id":"1169"}]],"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":["0xBa5e05cb26b78eDa3A2f8e3b3814726305dcAc83"],"type":"string"},"network":{"const":"eip155:8453","examples":["eip155:8453"],"type":"string"},"ok":{"const":true,"examples":[true],"type":"boolean"},"owner":{"examples":["0x8BA0D7704dF6a610F4ce9937d31E0Bbc19717311"],"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 Base wallet and up to 20 token ids via balanceOfBatch. Send contract, owner, and comma-separated token_ids. Example: Basepaint 1168 and 1169. Read-only. No spend. Send JSON {\"contract\":\"0xBa5e05cb26b78eDa3A2f8e3b3814726305dcAc83\",\"owner\":\"0x8BA0D7704dF6a610F4ce9937d31E0Bbc19717311\",\"token_ids\":\"1168,1169\"}. Exact $0.003 USDC on Base. Try unpaid POST /v1/sandbox/base-erc1155-balance first.","last_updated":"2026-10-22T07:20:45.247Z","schemes":["exact"]}