NFT API

List wallet holders of an NFT collection

Returns the list of wallet addresses that currently hold any token from the specified NFT collection. Useful for snapshotting an allowlist, computing distribution stats, or driving holder-gated drops.

Pass the contractAddress of the collection plus the blockchain it lives on. Page through large collections with pageSize (default 1000, max 10000) and the nextPageToken echoed in each response.

Part of the NFT API product (700 compute units per call, $0.00007 at base rate).

post/?ankr_getNFTHolders

Request

Request body

idinteger required

Client-supplied request ID echoed in the response.

jsonrpc'2.0' required
method'ankr_getNFTHolders' required

Example request

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "ankr_getNFTHolders",
  "params": {
    "blockchain": "arbitrum",
    "contractAddress": "0xc36442b4a4522e871399cd717abdd847ab11fe88",
    "pageSize": 10
  }
}

Response

Success. JSON-RPC result envelope contains the holders array and a pagination cursor. JSON-RPC errors are returned with HTTP 200 — check for an error key in the response body.

idinteger required
jsonrpc'2.0' required

Changes

No recorded changes to this operation across all 1 revision of this API.