How do I install the Nansen Perp Screener skill?

Run npx skillmds@latest add nansen-ai/nansen-perp-screener in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Nansen Perp Screener safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Nansen Perp Screener?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Nansen Perp Screener free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Nansen Perp Screener?

nansen-ai (@nansen-ai) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Nansen Perp Screener by nansen-ai — Agent Skill

Name: Nansen Perp Screener
Rating: 4.2 (5 reviews)
Author: nansen-ai

File contents

Perp Market Scan

Answers: "What's the state of the Hyperliquid perp market right now?"

nansen research perp screener --sort volume:desc --limit 20
# → token_symbol, volume, buy/sell_volume, buy_sell_pressure, open_interest, funding, mark_price

nansen research perp leaderboard --days 7 --limit 20
# → trader_address, trader_address_label, total_pnl, roi, account_value

nansen research smart-money perp-trades --limit 20
# → token_symbol, side, action (Open/Close), value_usd, price_usd, trader_address_label

New Filters (ECINT-6680)

`--trader-type`

Filter by trader type. Accepted values: all (default), sm, whale, public_figure, high_winrate_hl_perps_trader.

# Show only whale traders
nansen research perp screener --trader-type whale --limit 10

# Show only smart money traders
nansen research perp screener --trader-type sm --limit 20

# Show high win-rate HL perps traders
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.

# Filter to a specific SM label
nansen research perp screener --trader-type sm --sm-label-filter "30D Smart Trader"

# Multiple labels
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.

# Filter to HL Perps Whale label
nansen research perp screener --trader-label-filter "HL Perps Whale"

`--sectors-filter`

Comma-separated category:subcategory pairs to filter coins by sector.

# Filter to AI and DeFi crypto sectors
nansen research perp screener --sectors-filter "Crypto:AI,Crypto:DeFi" --trader-type whale

# Combine with trader type and limit
nansen research perp screener --sectors-filter "Crypto:AI,Crypto:DeFi" --trader-type whale --limit 10 --sort volume:desc

Combined Examples

# Whale traders in AI crypto, sorted by volume
nansen research perp screener --trader-type whale --sectors-filter "Crypto:AI" --sort volume:desc --limit 10

# Smart money with specific label, last 7 days
nansen research perp screener --trader-type sm --sm-label-filter "30D Smart Trader" --days 7 --limit 20

# All traders in TradFi stocks sector
nansen research perp screener --sectors-filter "TradFi:Stocks" --sort open_interest:desc --limit 20

---name: nansen-perp-screenerdescription: What is the state of the Hyperliquid perp market? Top contracts by volume/OI, trader leaderboard, and SM perp activity.---# Perp Market Scan**Answers:** "What's the state of the Hyperliquid perp market right now?"```bashnansen research perp screener --sort volume:desc --limit 20# → token_symbol, volume, buy/sell_volume, buy_sell_pressure, open_interest, funding, mark_pricenansen research perp leaderboard --days 7 --limit 20# → trader_address, trader_address_label, total_pnl, roi, account_valuenansen research smart-money perp-trades --limit 20# → token_symbol, side, action (Open/Close), value_usd, price_usd, trader_address_label```## New Filters (ECINT-6680)### `--trader-type`Filter by trader type. Accepted values: `all` (default), `sm`, `whale`, `public_figure`, `high_winrate_hl_perps_trader`.```bash# Show only whale tradersnansen research perp screener --trader-type whale --limit 10# Show only smart money tradersnansen research perp screener --trader-type sm --limit 20# Show high win-rate HL perps tradersnansen 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`.```bash# Filter to a specific SM labelnansen research perp screener --trader-type sm --sm-label-filter "30D Smart Trader"# Multiple labelsnansen 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`.```bash# Filter to HL Perps Whale labelnansen research perp screener --trader-label-filter "HL Perps Whale"```### `--sectors-filter`Comma-separated `category:subcategory` pairs to filter coins by sector.```bash# Filter to AI and DeFi crypto sectorsnansen research perp screener --sectors-filter "Crypto:AI,Crypto:DeFi" --trader-type whale# Combine with trader type and limitnansen research perp screener --sectors-filter "Crypto:AI,Crypto:DeFi" --trader-type whale --limit 10 --sort volume:desc```## Combined Examples```bash# Whale traders in AI crypto, sorted by volumenansen research perp screener --trader-type whale --sectors-filter "Crypto:AI" --sort volume:desc --limit 10# Smart money with specific label, last 7 daysnansen research perp screener --trader-type sm --sm-label-filter "30D Smart Trader" --days 7 --limit 20# All traders in TradFi stocks sectornansen research perp screener --sectors-filter "TradFi:Stocks" --sort open_interest:desc --limit 20```

Frequently asked questions

Nansen Perp Screener