get_token_holders
Retrieve token holder wallets and unique holder count, sorted by balance. Provides data for analyzing token distribution and ownership.
Instructions
Returns list of wallets that hold a given token, ordered by holdings descending. Also has the unique count of holders for that token. (Codex Growth and Enterprise Plans only)
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"networkId": "<networkId>",
"address": "<address>"
},
"name": "get_token_holders"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | Sort options for the holders list | |
| cursor | No | Cursor for pagination | |
| address | Yes | The token contract address | |
| networkId | Yes | The network ID the token is on |