Skip to content
onelayer.
All tools

Tool detail

erc1155-balance

Returns how many units of an ERC1155 token_id an address holds on an EVM chain, via an eth_call to balanceOf.

Categories: Onchain data, Token analytics

Use when

  • check how many of a specific ERC1155 token_id a wallet owns
  • verify an ERC1155 edition balance before a trade or airdrop

Not for

  • not for ERC721 single-NFT ownership (use nft-owner)
  • not a full wallet token/NFT portfolio listing

Inputs

GET query: address, contract (0x... 40-hex addresses, required), token_id (digit string, required); network (ethereum|sepolia|robinhood, optional, default ethereum)

Admitted input schema

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "pattern": "^0x[a-fA-F0-9]{40}$"
    },
    "contract": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "pattern": "^0x[a-fA-F0-9]{40}$"
    },
    "network": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "enum": [
        "ethereum",
        "sepolia",
        "robinhood"
      ],
      "default": "ethereum"
    },
    "token_id": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "pattern": "^[0-9]+$"
    }
  },
  "required": [
    "address",
    "contract",
    "token_id"
  ],
  "additionalProperties": false
}

Endpoint

Method
GET
URL
https://api.onesource.io/api/chain/erc1155-balance

Payment

Protocol
x402
Listed price
0.003 USDC per call on Base (eip155:8453)
Payment method
exact
Network
eip155:8453
Asset
0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

Listed terms are catalog metadata. The caller supplies inputs and calls the tool outside Onelayer. If payment is required, the caller uses a compatible wallet to pay.

Source

Record
GET https://api.onesource.io/api/chain/erc1155-balance
Retrieved
2026-09-30T20:37:07.382Z
Catalog file SHA-256
6837ccddf886f0007cf3727ea9d27faaa5047b51b4f425345c554ce1c271a524
Catalog built
2026-09-30T22:31:58.034Z