✨NFT Holder List

Returns the list of addresses and their count of NFTs held of a requested NFT project

https://api.vechainstats.com/v2/nft/holder-list
    ?id=exoworlds
    &threshold=100
    &page=
    &VCS_API_KEY=your_api_key

Note : This endpoint is throttled to 10 calls/minute regardless of API Pro tier.

Request

Parameter	Description
id	The ID of a NFT project, can be found in the NFT Token List endpoint
treshold (optional)	Setting this to an Integer value limits the response addresses to those that hold an amount equal or above the treshold value
page	the integer page number, the available pages are shown in the response meta fields

Response

{
    "status": {
        "success": true,
        "message": "OK"
    },
    "data": {
        "0xe860cef926e5e76e0e88fdc762417a582f849c27": 512,
        "0xaee087732f2c4a81e13f08ced9933f825c1daf6a": 317,
        "0xc71757050454d093513fcafd2eb41e4ca844b6a1": 303,
        "0x5a48bcf53a73665cd905d1157825665cfce856ad": 262,
        "0x2b57dbd11c5e9b3981d39b5452f44765f33faee6": 260,
        "0x2c43caa2b1be58b3e1dc286f291c7da9a40a4245": 258,
        "0xa979e29f5a7bcc852477c196272769be047313bb": 193,
        "0xc4afdf8e62921a7243fb3449d9d5fbb98dd5cf27": 134,
        "0xf1b501976af0ba3f169f80796daba21e0df921d6": 129,
        "0x5aa85851a9078b0738316085e7d66dbd43e46fbe": 117,
        "0x1b311eecd4cf97d4f90229e0d6ab1b7d7458dec4": 115,
        "0x91fc5056704812ae6c21935bfd3ddba61e63ddc3": 110,
        "0xd3c9cf42bf4bdb6a8b88fac4ad95a8aaa3a8e934": 106,
        "0x7cf42dbcd56f6d23d99d524ffc174955a060993e": 104,
        "0x1e9368a3cb7eaf7d86b23aedabe52da341dbe509": 103,
        "0x3c84b20e0e236fecb999c006ef08ecbc59879bd9": 101
    },
    "meta": {
        "count": 16,
        "id": "exoworlds",
        "threshold": 100,
        "name": "ExoWorlds",
        "contract": "0x3473c5282057d7beda96c1ce0fe708e890764009",
        "holders": 896,
        "timestamp": 1696257011
    }
}