# Token Holder List

{% hint style="info" %}
**Note :** This endpoint is throttled to **10 calls/minute** regardless of API Pro tier.
{% endhint %}

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

{% tabs %}
{% tab title="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                                            |
| {% endtab %}          |                                                                                                                                 |

{% tab title="Response" %}

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

{% endtab %}
{% endtabs %}