POSTGet NFT Holders by Token ID

Data APIhttps://web3.nodit.io/v1/ethereum/mainnet/nft/getNftHoldersByTokenId

Retrieves the holder list for a specific NFT. The holder list includes holder addresses and the quantity of NFTs held by each holder.

chainstring (enum)required

Parameter to specify the target chain for the query.

networkstring (enum)required

Parameter to specify the network of the target chain. Supported networks may vary depending on the chain.

contractAddressstringrequired

Parameter specifying the contract address to query. Can be entered as a 40-character hexadecimal string starting with 0x.

tokenIdstringrequired

Parameter specifying the NFT token ID to query. Can be entered as a decimal string.

pageinteger

The page parameter specifies the data page to query. It accepts values up to 100; for pages exceeding 100, use the cursor pagination method.

The page and cursor parameters cannot be used together. If both page and cursor are empty, cursor pagination is used.

rppinteger

rpp stands for results per page and specifies the page size. You can specify a number greater than 0 and up to 100.

cursorstring

The cursor parameter supports pagination and data navigation between pages. Provide the cursor value from the previous page in the next request to load the next page of data.

The page and cursor parameters cannot be used together. If both page and cursor are empty, cursor pagination is used.

withCountboolean

Parameter specifying whether to include the count field in the response. The count field indicates the total number of requested data items. When set to true, the count field is included and response speed may be slower.

pageinteger

Field representing the page number specified in the page parameter. This field is only included in the response when a value greater than 0 is specified for the page parameter.

rppinteger

Field representing the number of results per page specified in the rpp parameter.

cursorstring

A field for cursor pagination. This value must be provided in the next request to load the next page of data.

countinteger

Field representing the total count of requested data. This field is only included in the response when true is set for the withCount parameter.

ownerAddressstringrequired

A field representing the owner address.

totalBalancestringrequired

Returns the sum of all balance quantities for the contract.

[Note] The quantity calculation method may vary depending on the contract type. For ERC721, it equals uniqueBalance; for ERC1155, it returns the sum of all quantities.

(Example) ERC721: Returns 3 if holding #100, #200, #300 ERC1155: Returns 600 if holding 100 of #1, 200 each of #200 and #300

uniqueBalancestringrequired

Returns the number of distinct token IDs among the NFTs held by the contract.

[Note] The quantity calculation method may vary depending on the contract type. For ERC721, it equals totalBalance; for ERC1155, it returns the number of unique token IDs.

(Example) ERC721: Returns 3 if holding #100, #200, #300 ERC1155: Returns 3 if holding 100 of #1, 200 each of #200 and #300