nansen: nansen_token_holders
nansen_token_holdersTop holders of a token with labels, balance, USD value, ownership %, and 24h/7d/30d balance changes. Filter to Smart Money, whales, public figures or exchanges. 5 credits.
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": {
"chain": "<chain>",
"token_address": "<token_address>"
},
"name": "nansen_token_holders"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number for pagination (default 1) | |
| chain | Yes | ||
| limit | No | Rows to return (1-100, default 20) | |
| sort_by | No | Sort field (default value_usd) | |
| label_type | No | Holder group (default all_holders) | |
| token_address | Yes | Token contract address (use nansen_search to resolve a symbol first) | |
| include_labels | No | Only include wallets carrying at least one of these labels | |
| sort_direction | No | Sort direction (default DESC) | |
| aggregate_by_entity | No | Group wallets by entity (default false; not allowed with smart_money) |