Looking Glass
Get NFT holders by contract address
Get list of NFT holders and number of NFTs held by contract address.
Path Parameters
chainIdstring
A supported evm chain id. Use the /chains endpoint to get a list of supported chain ids.
addressstring
Contract address on the relevant chain.
Query Parameters
pageToken?string
A page token, received from a previous list call. Provide this to retrieve the subsequent page.
pageSize?integer
The maximum number of items to return. The minimum page size is 1. The maximum pageSize is 5000.
Default
1000Range
1 <= value <= 5000Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://metrics.avax.network/v2/chains/43114/contracts/0x7a420AEFF902AAa2c85a190D7B91Ce8BEFffFE14/nfts:listHolders?pageSize=10"{
"nextPageToken": "string",
"addresses": [
{
"address": "0x1234567890abcdef1234567890abcdef123456789",
"sortKey": 123
}
],
"nftCollectionName": "NFT Project",
"nftSymbol": "NFTPROJ",
"totalHolders": 10,
"totalTokens": 10
}{
"message": "string",
"statusCode": 400,
"error": "Bad Request"
}{
"message": "string",
"statusCode": 401,
"error": "Unauthorized"
}{
"message": "string",
"statusCode": 403,
"error": "Forbidden"
}{
"message": "string",
"statusCode": 404,
"error": "Not Found"
}{
"message": "string",
"statusCode": 429,
"error": "Too Many Requests"
}{
"message": "string",
"statusCode": 500,
"error": "Internal Server Error"
}{
"message": "string",
"statusCode": 502,
"error": "Bad Gateway"
}{
"message": "string",
"statusCode": 503,
"error": "Service Unavailable"
}Is this guide helpful?