| name | nansen-perp-screener |
| description | What is the state of the Hyperliquid perp market? Top contracts by volume/OI, trader leaderboard, and SM perp activity. |
| metadata | {"openclaw":{"requires":{"env":["NANSEN_API_KEY"],"bins":["nansen"]},"primaryEnv":"NANSEN_API_KEY","install":[{"kind":"node","package":"nansen-cli","bins":["nansen"]}]}} |
| allowed-tools | Bash(nansen:*) |
Perp Market Scan
Answers: "What's the state of the Hyperliquid perp market right now?"
nansen research perp screener --sort volume:desc --limit 20
nansen research perp leaderboard --days 7 --limit 20
nansen research smart-money perp-trades --limit 20
New Filters (ECINT-6680)
--trader-type
Filter by trader type. Accepted values: all (default), sm, whale, public_figure, high_winrate_hl_perps_trader.
nansen research perp screener --trader-type whale --limit 10
nansen research perp screener --trader-type sm --limit 20
nansen research perp screener --trader-type high_winrate_hl_perps_trader --limit 20
--sm-label-filter
Comma-separated Nansen SM labels to filter by. Only applies when --trader-type is all or sm.
nansen research perp screener --trader-type sm --sm-label-filter "30D Smart Trader"
nansen research perp screener --sm-label-filter "30D Smart Trader,Smart LP"
--trader-label-filter
Comma-separated HL perps trader labels to filter by. Only applies when --trader-type is all or sm.
nansen research perp screener --trader-label-filter "HL Perps Whale"
--sectors-filter
Comma-separated category:subcategory pairs to filter coins by sector.
nansen research perp screener --sectors-filter "Crypto:AI,Crypto:DeFi" --trader-type whale
nansen research perp screener --sectors-filter "Crypto:AI,Crypto:DeFi" --trader-type whale --limit 10 --sort volume:desc
Combined Examples
nansen research perp screener --trader-type whale --sectors-filter "Crypto:AI" --sort volume:desc --limit 10
nansen research perp screener --trader-type sm --sm-label-filter "30D Smart Trader" --days 7 --limit 20
nansen research perp screener --sectors-filter "TradFi:Stocks" --sort open_interest:desc --limit 20