VCS API Documentation
VeChain Stats
  • Introduction
  • Getting Started
    • 🗝️Getting an API Key
    • 🔓Authentication
    • 📬Postman
    • ✳️Swagger
  • API Endpoints
    • Account
      • Account Stats
      • ✨Account Extended Stats
      • Account Info
      • ✨Account VTHO Info
      • VET/VTHO Balance
      • ✨Transactions In
      • Transactions Out
      • ✨Token Transfers
      • ✨NFT Transfers
      • ✨DEX Trades
      • DEPRECATED: Internal Transfers
      • Historic VET/VTHO
    • Token
      • Token List
      • Token Info
      • Token Price
      • ✨Token Price List
      • Token Supply
      • ✨VIP180 Balance
      • VIP180 Balance Custom
      • ✨Token Holder List
    • Transaction
      • Transaction Status
      • Transaction Info
    • Block
      • Block Daily Stats
      • Block Info
      • Block Height
      • Block by reference
      • Block by timestamp
    • Contract
      • Contract Stats
      • Contract Info
      • Contract Code
    • NFT
      • NFT Token List
      • NFT Info
      • ✨VIP181 Balance
      • VIP181 Balance Custom
      • ✨NFT Holder List
    • Carbon
      • Address Emission
      • Block Emission
      • Transaction Emission
      • Network Emission
    • Network
      • Network Totals
      • Network Stats
      • Network Gas Stats
      • Authority Nodes
      • ✨Mempool
      • Node Token Count
      • ✨Node Token Stats
      • Thor Instance Size
      • X-Node List
    • API Info
      • API Info
      • API Ping
  • Support
    • FAQ
    • Rate Limits
    • Response HTTP Status
    • Common Error Messages
    • Socials
    • Change Log
  • Visit VeChain Stats
Powered by GitBook
On this page

Was this helpful?

  1. API Endpoints
  2. NFT

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

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

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

Last updated 1 year ago

Was this helpful?

✨