@nansen-ai/nansen-perp-screener

What is the state of the Hyperliquid perp market? Top contracts by volume/OI, trader leaderboard, and SM perp activity.

View in AI SkillSafe app
0 downloads
0 stars
0 demos
SKILL.md
namenansen-perp-screener
descriptionWhat is the state of the Hyperliquid perp market? Top contracts by volume/OI, trader leaderboard, and SM perp activity.
metadataNANSEN_API_KEY
allowed-toolsBash(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
# → 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

Embed badges

Add these to your README to show the skill's verification status.

SkillSafe verified badge
Verified badge
[![SkillSafe verified badge](https://api.skillsafe.ai/v1/badge/@nansen-ai/nansen-perp-screener/verified)](https://skillsafe.ai/skill/@nansen-ai/nansen-perp-screener/)
Installs badge
Installs badge
[![Installs badge](https://api.skillsafe.ai/v1/badge/@nansen-ai/nansen-perp-screener/installs)](https://skillsafe.ai/skill/@nansen-ai/nansen-perp-screener/)
Scan badge
Scan badge
[![Scan badge](https://api.skillsafe.ai/v1/badge/@nansen-ai/nansen-perp-screener/scan)](https://skillsafe.ai/skill/@nansen-ai/nansen-perp-screener/)
Eval pass rate badge
Eval pass rate
[![Eval pass rate badge](https://api.skillsafe.ai/v1/badge/@nansen-ai/nansen-perp-screener/eval)](https://skillsafe.ai/skill/@nansen-ai/nansen-perp-screener/)