Get all holders who currently possess NFTs from a specific collection
Authorization required to use this endpoint
To get your API key, follow the instruction here.
The Current Collection Holders endpoint allows you to retrieve data on all holders possessing NFTs from a specific collection. To perform a search, it is necessary to provide the address of the contract being searched. Additionally, the metadata
and sale_price
information can be included by setting their field values to true
.
A successful request to the endpoint will return a JSON response with the data on all holders owning NFTs from a particular collection marked as items. The items will contain their id
, token_id
, and transfer
data, along with metadata
and sale_price
information if you choose to include them in your response. The transfer
data will consist of the following fields: owner
, block_number
, block_timestamp
, and transaction_hash
.
The cURL request shown below can give you the gist of how the endpoint operates. Be sure to replace YOUR_API_KEY
with your actual API key.
curl --location 'https://api.parsiq.net/nft/eip155-1/v1/0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D/owner?metadata=true' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY'