✨Token Holder List

Returns the list of addresses and their count of tokens held of a requested VIP180 Token

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

https://api.vechainstats.com/v2/token/holder-list
    ?token=vet
    &threshold=1250000000
    &page=1
    &VCS_API_KEY=your_api_key

Request

Parameter	Description
token	Symbol of the requested token
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": {
        "0xd0d9cd5aa98efcaeee2e065ddb8538fa977bc8eb": "7977822092.24503776546074",
        "0xfde60d8e6ea93654364c34b04155cc81063b6c6a": "5983483811.35809508932812",
        "0x1263c741069eda8056534661256079d485e111eb": "4907167006",
        "0x058a871358c1b01039a265635ea282c3f435a9ed": "3331894389.729398",
        "0xcecc1b17d875e9d94847379c536954fa546faae0": "3284370381.21542342",
        "0x8db1490f413dff85ee18ce6ab24e518fbb2dbdfe": "2422110393.92839135389128",
        "0x9f0a53db6dc336f0b50ac35254433869a16d15a0": "1781662474.50849483126314",
        "0xa6d080563b4a1cef3ab8caf67293ee239189967c": "1720482756.31365952534682",
        "0x8aa382728ca7ebb62202a2e6729078113d82fef4": "1450005001"
    },
    "meta": {
        "count": 9,
        "page": 1,
        "pages": 1,
        "per_page": 200,
        "token": "vet",
        "threshold": 1250000000,
        "name": "VeChain",
        "symbol": "vet",
        "contract": null,
        "holders": 654805,
        "timestamp": 1696328745
    }
}