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'