Get an Item's Holders

Get an item's holders

Returns an item's holders and their balances

GET https://api.alturanft.com/api/v2/item/holders/:address/:tokenId

Takes an address and tokenId and returns all the holders for a particular item and their balance.

Sorted by descending balance (largest holder first)

Path Parameters

Name	Type	Description
address*	String	The item's collection address
tokenId*	Integer	The item's tokenId

Query Parameters

Name	Type	Description
perPage	Integer	The number of users to return (default: 24)
page	Integer	The offset for returned users. Calculated as (page - 1) * perPage (default: 1)
includeListed	Boolean	If user's who have their item listed should be included (listed NFTs are still owned by the user, however on the blockchain they are held by a marketplace smart contract) (default: true)

200: OK

{
  "holders": [
    {
      "address": "0xf1151f738581f4f576ca28eef4844e7d91faad1b",
      "balance": 3,
      "name": "The Altura OG ",
      "profilePic": "https://ipfs.io/ipfs/QmSTV9SZaSZn7Wyh4cM9q7fXovuLSitSiDFHRTgUQYBXJZ",
      "profilePicUrl": "https://altura-marketplace-1.s3.us-east-2.amazonaws.com/0xf1151f738581f4f576ca28eef4844e7d91faad1b_ad34c68d-b90c-4cca-a254-4266607ef1eb.png"
    },
    {
      "address": "0xf5504b784f3981a08f7463c3dfcb83a846328f6e",
      "balance": 3,
      "name": "@pujken",
      "profilePic": "https://ipfs.io/ipfs/Qmee3iEAShitMw8h93UiJaY4wrG9VhSchAT3H5b5ob56Rf",
      "profilePicUrl": "https://altura-marketplace-1.s3.us-east-2.amazonaws.com/0xf5504b784f3981a08f7463c3dfcb83a846328f6e_55da08bc-a18a-4386-b34a-dc04948abd53.png"
    },
    ...
   ],
  "count": 93
}

500: Internal Server Error

{
    // Response
}