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)
{
"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
}
Last updated