smart_traders_and_funds_perp_trades

io.github.nansen-ai/nansen-mcp · Verify this server

Get recent Hyperliquid perpetual futures trades from Smart Traders and Funds across all tokens. This tool provides granular smart trader and funds activity. For a big picture view of smart traders and funds activity across all tokens, use token_discovery_screener with traderType="sm" filter. **Note:** This endpoint is Hyperliquid-only (perpetual futures data). It returns recent trades only (no date filtering available). Columns returned: - **Time**: Timestamp when the trade occurred (datetime: YYYY-MM-DD HH:MM:SS) - **Side**: Position direction - Long or Short - **Action**: Order action - Add, Reduce, Open, Close - **Token**: Symbol of the perpetual contract - **Size**: Quantity of the perpetual contract (numeric) - **Price USD**: Price per token at time of trade (price formatted) - **Value USD**: Total USD value of the trade (currency formatted) - **Trader**: Nansen label of the trading address - **Address**: Full trading wallet address - **Tx Hash**: Blockchain transaction hash for verification Sorting Options (all fields support "asc"/"desc"): Available for sorting: timestamp, amount, price_usd Examples: # Get recent smart money perp trades (sorted by amount) ``` { "orderBy": "amount", "order_by_direction": "desc" } ``` # Filter by action and side ``` { "action": "Open", "side": "Long", "includeSmartMoneyLabels": ["Fund", "All Time Smart Trader"] } ```