Get Top Token Holders
Retrieves top token holders ranked by balance (largest first) with holdings and supply percentage. Returns wallet addresses, USD values, and optional labels (exchange, fund, etc.); limit configurable. Ideal for: whale tracking, holder concentration analysis, identifying major token stakeholders.
Catalog action Blockchain Data
Retrieves top token holders ranked by balance (largest first) with holdings and supply percentage. Returns wallet addresses, USD values, and optional labels (exchange, fund, etc.); limit configurable. Ideal for: whale tracking, holder concentration analysis, identifying major token stakeholders.
At a Glance
| Field | Value |
|---|---|
| Action ID | coingecko-get-top-token-holders |
| Category | Blockchain Data |
| Connector | Not required |
| Requires gas | No |
| Funds movement | None declared |
| Tags | coingecko, onchain, token, holders, whales, read |
Payload Schema
| Field | Type | Required | Description |
|---|---|---|---|
network | string | Yes | Network ID (e.g., 'eth', 'base', 'solana'). |
tokenAddress | string | Yes | Token contract address. |
holders | number | string | No | Number of holders to return (integer or 'max'). Default: 1. Max: 50 for non-Solana, 40 for Solana. |
Result Schema
| Field | Type | Required | Description |
|---|---|---|---|
lastUpdatedAt | string | null | No | When holder data was last updated. |
holders | array | Yes | List of top holders with rank, address, amount, percentage, and value. |
Examples
json{ "type": "coingecko-get-top-token-holders", "payload": { "network": "example-network", "tokenAddress": "0x0000000000000000000000000000000000000000" }, "children": []}
bashcurl -X POST "https://api.b3os.org/v1/actions/coingecko-get-top-token-holders/test" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "inputs": { "network": "example-network", "tokenAddress": "0x0000000000000000000000000000000000000000" }}'
Payload fields can use workflow expressions such as {{$trigger.body.amount}}, {{$nodes.fetch.result.price}}, and {{$props.asset}} when the value should come from a trigger, prior node, or reusable workflow prop.