---
updatedAt: 2026-09-24T09:33:47.000Z
agentTools:
projectIndex: https://docs.blockvision.org/llms.txt
---
# Retrieve Collection Holders
Returns holders of a NFT collection by a given object type.
### Supported on Sui Mainnet.
### The NFT Collection Holders API on Sui is currently exclusively available to Pro Members. However, non-Pro members can also enjoy a trial period with an allocation of 30 free calls. If you're interested, please register directly through [here](https://dashboard.blockvision.org/overview). Please note that the API Key can also be used for your GRPC endpoint.
## Parameter
* `objectType`, `string` - the object type supplied for getting holders of an NFT collection.
* `cursor`, `string` - next page cursor.
* `limit`, `integer` - the maximum number of results to return per page. Defaults to 20, maximum is 50.
## Response
`object` - a returned object with NFT collection holders info, next page index and total number of NFT collection holders. Contains:
* `data` - an array of NFT collection holder objects. An empty array will be returned if there are no holders.
* `owner`, `string` - the address of the owner of an NFT collection.
* `count`, `integer` - the number of holders of an NFT collection.
* `nextPageCursor`, `string` - Cursor used for paginating to the next page of results.
* `total`, `integer` - the number of holders of an NFT collection.
For higher throughput, [create your own API key](https://forms.gle/SxR3Wx7tpjhmQ37u7).
# OpenAPI definition
```json
{
"openapi": "3.1.0",
"info": {
"title": "blockvision_v2",
"version": "2.0"
},
"servers": [
{
"url": "https://api.blockvision.org/v2"
}
],
"components": {
"securitySchemes": {
"sec0": {
"type": "apiKey",
"in": "header",
"name": "x-api-key"
}
}
},
"security": [
{
"sec0": []
}
],
"paths": {
"/sui/nft/collection/holder": {
"get": {
"summary": "Retrieve Collection Holders",
"description": "Returns holders of a NFT collection by a given object type.",
"operationId": "retrieve-collection-holders",
"parameters": [
{
"name": "objectType",
"in": "query",
"description": "`string` - the object type supplied for getting holders of an NFT collection.",
"required": true,
"schema": {
"type": "string",
"default": "0xf1681f601a1c021a0b4c8c8859d50917308fcbebfd19364c4e856ac670bb8496::suishi::Suishi"
}
},
{
"name": "cursor",
"in": "query",
"description": "",
"schema": {
"type": "string",
"default": ""
}
},
{
"name": "limit",
"in": "query",
"description": "",
"schema": {
"type": "integer",
"format": "int32",
"default": "20"
}
}
],
"responses": {
"200": {
"description": "200",
"content": {
"application/json": {
"examples": {
"Result": {
"value": {
"code": 200,
"message": "OK",
"result": {
"data": [
{
"count": "56",
"owner": "0x750efb8f6d1622213402354bfafb986ac5674c2066e961badf83c7ccd2dc5505",
"percentage": "1.87%"
},
{
"count": "49",
"owner": "0x0bb83b54135a88456cef322a8fba5ee496e7e751c5b07ffc119cceed9e309297",
"percentage": "1.63%"
},
{
"count": "43",
"owner": "0x9fd1c3cc2f52c4aa6ef01b3f21c26b4f85a750c6716a6d2736735c0a65adec84",
"percentage": "1.43%"
},
{
"count": "38",
"owner": "0x1f3de6a5633099328d1037deef36aee4e93fd569479181f16480ca791e90bbb3",
"percentage": "1.27%"
},
{
"count": "35",
"owner": "0x964d3d01b9b433cefa1ce518f05c825e6a7c61c3925ae13c2643aaaa9688ebda",
"percentage": "1.17%"
},
{
"count": "31",
"owner": "0xc6bfb51520c70bd676d2535a84fa3c6d1256e119bf4169c21c177e84432787ba",
"percentage": "1.03%"
},
{
"count": "31",
"owner": "0x185285b6df9030cd0c44b4c4570dc8a4607ebb9d79b1acbb461489b40791bb0e",
"percentage": "1.03%"
},
{
"count": "30",
"owner": "0x67c2fb31a0917915cea7250fa530af85baa973f52aa8d703260b427fa48848f8",
"percentage": "1.00%"
},
{
"count": "24",
"owner": "0x1b585ee3017e5dc0e59acba63092c3a8986225edc5200d9d6d13069743b60bae",
"percentage": "0.80%"
},
{
"count": "23",
"owner": "0x599d03c572b5a49b47d3f702a6368c5e4c86a7ca53c391fa1ced8f5fc3211922",
"percentage": "0.77%"
},
{
"count": "22",
"owner": "0x6111e1d2f9045feb9b4197cac1ea648c3c58f6937cd166a565238411a2302427",
"percentage": "0.73%"
},
{
"count": "22",
"owner": "0x43612099bc19ece87d6cb256fbd9d94ae9b691d59f600fc504b5d6519e59e4e9",
"percentage": "0.73%"
},
{
"count": "22",
"owner": "0x404be914207630f6afb0a40918d1f3e16bf04f4deb53f8505a823bf1eb035900",
"percentage": "0.73%"
},
{
"count": "22",
"owner": "0x30effb3c9609580f6489f84be8132d9c2a497f66aa9f5407bd80f3e3c7a87537",
"percentage": "0.73%"
},
{
"count": "21",
"owner": "0xded2f5328582f1b7a18d5183f6bffcebfb8ca4ce638690ac6d2082711ce1cb92",
"percentage": "0.70%"
},
{
"count": "19",
"owner": "0xb83481c41b7aa4f8a3ecce45b109faa87891554b63730a8a1be0583cabc5b457",
"percentage": "0.63%"
},
{
"count": "19",
"owner": "0x7578280b2a156ba04717bd0119d0d4674640c8fae18b90de62c6209fd2aa7009",
"percentage": "0.63%"
},
{
"count": "18",
"owner": "0x92cbb003f33a6cf84127b69955b2c167c8918b1fa9c2133ae4309e8e16c42cfd",
"percentage": "0.60%"
},
{
"count": "18",
"owner": "0x4f21032bd4257c2d67a8f7c7bf8055f3c9516b57bb777cb0a724bb16adff63df",
"percentage": "0.60%"
},
{
"count": "18",
"owner": "0x4ed6d9b1dbcaf8ee20a079b5c150c1b1f2494c8dd292713fbaf3b0b5677aad57",
"percentage": "0.60%"
}
],
"nextPageCursor": "MA=="
}
}
}
},
"schema": {
"type": "object",
"properties": {
"code": {
"type": "integer",
"example": 200,
"default": 0
},
"message": {
"type": "string",
"example": "Success"
},
"result": {
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"type": "object",
"properties": {
"owner": {
"type": "string",
"example": "0x111fb2a8e2d67a4b5e761d0a9fc92e86eaad71d200168365f583f9861ac304cc"
},
"count": {
"type": "integer",
"example": 1,
"default": 0
}
}
}
},
"nextPageIndex": {
"type": "integer",
"example": 3,
"default": 0
},
"total": {
"type": "integer",
"example": 362,
"default": 0
}
}
}
}
}
}
}
},
"400": {
"description": "400",
"content": {
"application/json": {
"examples": {
"Result": {
"value": "{}"
}
},
"schema": {
"type": "object",
"properties": {}
}
}
}
}
}
}
}
},
"x-readme": {
"headers": [],
"explorer-enabled": true,
"proxy-enabled": true
},
"x-readme-fauxas": true
}
```