get_erc1155_balance
chainpeek: Get an account's ERC-1155 token balance for a token id on Ethereum, Base or Robinhood Chain. For an ERC-721 owner use get_nft_owner. Returns balanceOf(account, id) of an ERC-1155 contract (balance, a raw integer string), with an ERC-165 check (is_erc1155) and the block read. A contract without balanceOf(address,uint256) is a 422 not_erc1155 (not charged). Ethereum, Base and Robinhood only; read-only: nothing is signed or sent. RPC reads are cached up to 30 s. A bad address, hash, hex string, block or range is a 422 before any payment (not charged). Typically under 1 s. Price: USD 0.001. Free: 10 chain reads per IP per UTC day. Docs: https://tanod.dev/learn/ethereum-rpc-reads-api.html
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"chain": "<chain>",
"contract": "<contract>",
"account": "<account>",
"token_id": "<token_id>"
},
"name": "get_erc1155_balance"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| chain | Yes | ethereum, base or robinhood (Robinhood Chain, chain id 4663). | |
| account | Yes | Holder address. | |
| contract | Yes | ERC-1155 contract address. | |
| token_id | Yes | Token id (uint256) as a decimal or 0x-hex string. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| block | No | ||
| chain | No | ||
| error | No | Only on an error result: an object {code, message}, or the reason string of an x402 PaymentRequired object. | |
| account | No | ||
| balance | No | ||
| contract | No | ||
| token_id | No | ||
| is_erc1155 | No |