Sign in

v1

latestOpenAPI 3.1.02026-07-243035381.4 MB
NFT API

Get owners of a token

/v4/data/owners

50 credits per API call

> 📘 **Note for v3 API users:** > > As part of our documentation consolidation, we removed the dedicated page for GET /v3/data/owners. Users can refer to GET /v4/data/owners for the latest documentation, as both endpoints function the same—simply replace v4 with v3 in the API URL if using the v3 version.

Get all addresses that own your favorite token (ERC-20, ERC-721 or ERC-1155)! Our API lets you search for all token owners on:

  • Ethereum - ethereum-mainnet / ethereum-sepolia
  • Base - base-mainnet / base-sepolia
  • Arbitrum - arb-one-mainnet / arb-testnet
  • BNB (Binance) Smart Chain - bsc-mainnet
  • Polygon - polygon-mainnet
  • Optimism - optimism-mainnet / optimism-testnet
  • Berachain - berachain-mainnet
  • Unichain - unichain-mainnet / unichain-sepolia
  • Monad - monad-testnet
  • Celo - celo-mainnet / celo-testnet
  • Avalanche - avax-mainnet / avax-testnet
  • Gnosis - gno-mainnet / gno-testnet
  • zkSync - zksync-mainnet / zksync-testnet
  • Rootstock - rsk-mainnet / rsk-testnet
  • Ethereum Classic - ethereum-classic-mainnet / ethereum-classic-testnet
  • Lisk - lisk-mainnet / lisk-testnet

To get started:

  • Provide a chain name and address of any fungible token, NFT or multitoken collection. Our API will return a list of addresses of all of their owners.
  • You can also get an owner of a specific NFT by specifying tokenId. In case of multitoken, result is an array of addresses.
get/v4/data/owners

Query parameters

chain'ethereum-mainnet' | 'ethereum-sepolia' | 'base-mainnet' | 'base-sepolia' | 'arb-one-mainnet' | 'arb-testnet' | 'bsc-mainnet' | 'polygon-mainnet' | 'optimism-mainnet' | 'optimism-testnet' | 'berachain-mainnet' | 'unichain-mainnet' | 'unichain-sepolia' | 'monad-testnet' | 'celo-mainnet' | 'celo-testnet' | 'avax-mainnet' | 'avax-testnet' | 'gno-mainnet' | 'gno-testnet' | 'zksync-mainnet' | 'zksync-testnet' | 'rsk-mainnet' | 'rsk-testnet' | 'ethereum-classic-mainnet' | 'ethereum-classic-testnet' | 'lisk-mainnet' | 'lisk-testnet' required
Example:ethereum-mainnet

The blockchain to work with.

tokenAddressstring required

Contract address of the token.

Example:0xba30E5F9Bb24caa003E9f2f0497Ad287FDF95623

The blockchain address of the token (NFT collection or any fungible token).

tokenIdstring uint256

ID of the token.

Example:3

The ID of a specific NFT token.

pageSizenumber
Example:10

The number of items per page (default is 50).

offsetnumber

The offset to obtain next page of the data.

Response

OK

string[] required

List of all addresses that own a token in a specified collection.

Example response

[
  "0x0bbf9f25c863fdf19e645c96280004d24f43cb38",
  "0x0bd1b3b12db943f2310a4e53481ae97f8b6c2a75",
  "0x281f4727081ab4a066f321fd6fc8dd0dc063e9fd",
  "0x681cbae1c41e5eec8411dd8e009fa71f81d03f7f",
  "0x7b49a05c15702bbe1db534058ebcc9e950c474ca"
]