---
title: "GetTokenSupplies"
method: POST
path: "/rpc/Indexer/GetTokenSupplies"
tags: ["public"]
---

# GetTokenSupplies

`POST /rpc/Indexer/GetTokenSupplies`

GetTokenSupplies returns the set of tokenIDs used by a contract address, supporting ERC-20, ERC-721, and ERC-1155 contracts, and their respective supply as well.

## Request body

- IndexerGetTokenSuppliesRequest
  - `contractAddress` string
  - `includeMetadata` boolean
  - `metadataOptions` MetadataOptions
    - `verifiedOnly` boolean
    - `unverifiedOnly` boolean
    - `includeContracts` string[] — []string
  - `page` Page
    - `pageSize` number
    - `page` number
    - `more` boolean
    - `totalRecords` number
    - `column` string
    - `before` object
    - `after` object
    - `sort` SortBy[] — []SortBy
      - `column` string, required
      - `order` 'DESC' | 'ASC', required — Represented as uint32 on the server side

## Response `200`

OK

- IndexerGetTokenSuppliesResponse
  - `page` Page
    - `pageSize` number
    - `page` number
    - `more` boolean
    - `totalRecords` number
    - `column` string
    - `before` object
    - `after` object
    - `sort` SortBy[] — []SortBy
      - `column` string, required
      - `order` 'DESC' | 'ASC', required — Represented as uint32 on the server side
  - `contractType` 'UNKNOWN' | 'ERC20' | 'ERC721' | 'ERC1155' — Represented as uint16 on the server side
  - `tokenIDs` TokenSupply[] — []TokenSupply
    - `tokenID` string, required
    - `supply` string, required
    - `chainId` number, required
    - `contractInfo` ContractInfo
      - `chainId` number, required
      - `address` string, required
      - `name` string, required
      - `type` string, required
      - `symbol` string, required
      - `decimals` number
      - `logoURI` string, required
      - `deployed` boolean, required
      - `bytecodeHash` string, required
      - `extensions` ContractInfoExtensions, required
        - `link` string, required
        - `description` string, required
        - `categories` string[], required — []string
        - `ogImage` string, required
        - `ogName` string, required
        - `originChainId` number, required
        - `originAddress` string, required
        - `blacklist` boolean, required
        - `verified` boolean, required
        - `verifiedBy` string, required
        - `featured` boolean, required
      - `contentHash` number, required
      - `updatedAt` string, required
      - `notFound` boolean, required
      - `queuedAt` string
      - `status` 'NOT_AVAILABLE' | 'STALE' | 'AVAILABLE', required — Represented as uint32 on the server side
    - `tokenMetadata` TokenMetadata
      - `tokenId` string, required
      - `name` string, required
      - `description` string
      - `image` string
      - `video` string
      - `audio` string
      - `properties` object — map<string,any>
      - `attributes` object[], required — []map<string,any>
      - `imageData` string
      - `externalUrl` string
      - `backgroundColor` string
      - `animationUrl` string
      - `decimals` number
      - `updatedAt` string
      - `assets` Asset[] — []Asset
        - `id` number, required
        - `collectionId` number, required
        - `tokenId` string
        - `url` string
        - `metadataField` string, required
        - `filename` string
        - `filesize` number
        - `mimeType` string
        - `width` number
        - `height` number
        - `updatedAt` string
      - `status` 'NOT_AVAILABLE' | 'STALE' | 'AVAILABLE', required — Represented as uint32 on the server side
      - `queuedAt` string
      - `lastFetched` string

## Other responses

- `4XX` — Client error
- `5XX` — Server error

---

[API](https://skmtc.dev/sequence/apis/analytics-api.md) · [All operations](https://skmtc.dev/sequence/apis/analytics-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sequence/analytics-api/revisions/12db1459a050/schema)