nansen-perps: nansen_perp_trades
nansen_perp_tradesIndividual Hyperliquid trades on one coin: trader, side, action (open/close/add/reduce), order type, size, price, USD value. Filter for big trades or Smart Money. 1 credit.
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": {
"token_symbol": "<token_symbol>"
},
"name": "nansen_perp_trades"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| days | No | Look-back window in days ending now (default 1). Ignored when date_from is set. | |
| page | No | Page number for pagination (default 1) | |
| side | No | ||
| limit | No | Rows to return (1-100, default 20) | |
| action | No | ||
| labels | No | Restrict to wallets with these Smart Money labels. 'Smart Trader' = historically profitable spot traders; 'Smart HL Perps Trader' = profitable Hyperliquid perp traders. | |
| date_to | No | Explicit end (YYYY-MM-DD or ISO 8601). Defaults to now. | |
| sort_by | No | ||
| date_from | No | Explicit start (YYYY-MM-DD or ISO 8601). Overrides days. | |
| token_symbol | Yes | Hyperliquid coin symbol, e.g. 'BTC', 'ETH', 'SOL', 'HYPE' | |
| min_value_usd | No | ||
| sort_direction | No | Sort direction (default DESC) |