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.

Parameter

Description

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

{
    "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
    }
}

PreviousVIP181 Balance Custom NextCarbon

Last updated 1 year ago

Was this helpful?

{ "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 } }