get_tokens_networks_onchain_top_traders
Read-only
Identify top traders for a specific cryptocurrency token by providing its contract address and network to analyze trading activity and performance metrics.
Instructions
When using this tool, always use the jq_filter parameter to reduce the response size and improve performance.
Only omit if you're sure you don't need the data.
This endpoint allows you to query top token traders based on the provided token contract address on a network
Response Schema
{
$ref: '#/$defs/top_trader_get_response',
$defs: {
top_trader_get_response: {
type: 'object',
properties: {
data: {
type: 'object',
properties: {
id: {
type: 'string'
},
attributes: {
type: 'object',
properties: {
traders: {
type: 'array',
items: {
type: 'object',
properties: {
address: {
type: 'string'
},
average_buy_price_usd: {
type: 'string'
},
average_sell_price_usd: {
type: 'string'
},
explorer_url: {
type: 'string'
},
label: {
type: 'string'
},
name: {
type: 'string'
},
realized_pnl_usd: {
type: 'string'
},
token_balance: {
type: 'string'
},
total_buy_count: {
type: 'integer'
},
total_buy_token_amount: {
type: 'string'
},
total_buy_usd: {
type: 'string'
},
total_sell_count: {
type: 'integer'
},
total_sell_token_amount: {
type: 'string'
},
total_sell_usd: {
type: 'string'
},
type: {
type: 'string'
},
unrealized_pnl_usd: {
type: 'string'
}
}
}
}
}
},
type: {
type: 'string'
}
}
}
}
}
}
}Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| network_id | Yes | ||
| token_address | Yes | ||
| include_address_label | No | include address label data, default: false | |
| sort | No | sort the traders by field Default value: realized_pnl_usd_desc | |
| traders | No | number of top token traders to return, you may use any integer or `max` Default value: 10 | |
| jq_filter | No | A jq filter to apply to the response to include certain fields. Consult the output schema in the tool description to see the fields that are available. For example: to include only the `name` field in every object of a results array, you can provide ".results[].name". For more information, see the [jq documentation](https://jqlang.org/manual/). |