Nansen Perp Screener
- 344 installs
- 127 repo stars
- Updated August 4, 2026
- nansen-ai/nansen-cli
nansen-perp-screener is a Claude Code skill that runs Nansen CLI perp screener and leaderboard commands for developers who need Hyperliquid market state before building trading tools or committing capital.
About
nansen-perp-screener is a Nansen CLI agent skill that answers Hyperliquid perpetual futures market questions through Bash commands like `nansen research perp screener` and `nansen research perp leaderboard`. The skill requires the `nansen` binary and a `NANSEN_API_KEY`, returning sortable tables for token_symbol, volume, buy_sell_pressure, open_interest, funding, and mark_price with configurable `--sort` and `--limit` flags. Developers reach for nansen-perp-screener when wiring AI agents or local scripts that must surface top contracts by volume or open interest and smart-money perp activity without hand-rolling exchange API parsers. Install ships via the `nansen-cli` Node package and restricts allowed tools to `Bash(nansen:*)` for safe CLI-only execution.
- Perp futures screening
- Nansen CLI queries
- Liquidity signals
- On-chain derivatives
Nansen Perp Screener by the numbers
- 344 all-time installs (skills.sh)
- +3 installs in the week ending Aug 4, 2026 (Skillselion tracking)
- Ranked #322 of 1,106 Finance & Trading skills by installs in the Skillselion catalog
- Data as of Aug 5, 2026 (Skillselion catalog sync)
npx skills add https://github.com/nansen-ai/nansen-cli --skill nansen-perp-screenerAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 344 |
|---|---|
| repo stars | ★ 127 |
| Last updated | August 4, 2026 |
| Repository | nansen-ai/nansen-cli ↗ |
How do you screen Hyperliquid perps with Nansen CLI?
Screen perpetual futures markets with Nansen CLI to spot liquidity, positioning, and momentum signals before committing capital or building trading strategies.
Who is it for?
Developers building crypto trading agents or dashboards who already use Nansen CLI and need structured Hyperliquid perp market scans.
Skip if: Developers without a Nansen API key, non-Hyperliquid venues, or teams that need order execution rather than market screening.
When should I use this skill?
A developer asks for Hyperliquid perp market state, top contracts by volume or OI, or Nansen perp leaderboard data.
What you get
Sorted perp screener tables, trader leaderboard rows, and smart-money perp activity snapshots from Nansen CLI stdout.
- perp screener tables
- trader leaderboard output
- SM perp activity snapshots
By the numbers
- Default screener example uses --limit 20 contracts
- Installs nansen-cli Node package exposing the nansen binary
Files
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_labelNew 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:descCombined 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 20Related skills
Wind Mcp SkillGive their AI coding agent instant access to comprehensive Chinese and global equity, fund, bond, and macroeconomic data from Wind.77.6k74
Upgrade StripeSafely upgrade their Stripe API version and SDKs without introducing breaking changes.55.6k1.7k
Recipe Create Expense TrackerInstantly create a ready-to-use Google Sheets expense tracker with headers, sample data, and sharing permissions.24.4k30.2k
Backtesting FrameworksCreate realistic event-driven backtesters that simulate order execution, slippage, commissions, and position tracking before committing capital to a trading strategy.13.5k38.5k
Grimoire PolymarketQuery live Polymarket odds, search events, and manage conditional order flow directly from Claude or Cursor without leaving the IDE.11.9k6
CoinglassGive their AI coding agents real-time access to crypto derivatives market data such as funding rates, open interest, long/short ratios, liquidations, and futures OHLC h11.4k21How it compares
Choose nansen-perp-screener over generic exchange REST scripts when you need Nansen-labeled smart-money perp activity and leaderboard data alongside raw Hyperliquid metrics.
FAQ
What does nansen-perp-screener require to run?
nansen-perp-screener requires the `nansen` CLI from the `nansen-cli` Node package and a `NANSEN_API_KEY` environment variable. The skill metadata sets `primaryEnv` to NANSEN_API_KEY and limits tools to Bash(nansen:*).
Which Hyperliquid perp fields does the screener return?
nansen-perp-screener via `nansen research perp screener` returns token_symbol, volume, buy/sell_volume, buy_sell_pressure, open_interest, funding, and mark_price, with sorting flags like `--sort volume:desc` and `--limit 20`.