Get Top Token Traders
Retrieves top token traders ranked by realized PnL by default, with complete trading statistics. Returns PnL, balances, average prices, and trade counts; sortable by various metrics. Ideal for: identifying profitable traders, analyzing smart money movements, tracking token trading patterns.
Catalog action Blockchain Data
Retrieves top token traders ranked by realized PnL by default, with complete trading statistics. Returns PnL, balances, average prices, and trade counts; sortable by various metrics. Ideal for: identifying profitable traders, analyzing smart money movements, tracking token trading patterns.
At a Glance
| Field | Value |
|---|---|
| Action ID | coingecko-get-top-token-traders |
| Category | Blockchain Data |
| Connector | Not required |
| Requires gas | No |
| Funds movement | None declared |
| Tags | coingecko, onchain, token, traders, pnl, read |
Payload Schema
| Field | Type | Required | Description |
|---|---|---|---|
network | string | Yes | Network ID (e.g., 'eth', 'base', 'solana'). |
tokenAddress | string | Yes | Token contract address. |
traders | number | string | No | Number of traders to return (integer or 'max'). Default: 10. |
sort | string | No | Sort order. |
includeAddressLabel | boolean | No | Include address label data. |
Result Schema
| Field | Type | Required | Description |
|---|---|---|---|
traders | array | Yes | List of top traders with PnL, balances, and trading activity. |
Examples
json{ "type": "coingecko-get-top-token-traders", "payload": { "network": "example-network", "tokenAddress": "0x0000000000000000000000000000000000000000" }, "children": []}
bashcurl -X POST "https://api.b3os.org/v1/actions/coingecko-get-top-token-traders/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.