mcpField
N
nansen-perp

nansen-perp

github.com/nansen-aiData & databases14461 installsUpdated today
Repository

About nansen-perp

A skill for querying Hyperliquid perpetual markets and trader rankings through the nansen command line. It supports sorting and selecting output fields, with table and CSV output options.

Key features

  1. 01Perpetual market screener
  2. 02Trader leaderboard by PnL
  3. 03Sort and limit results
  4. 04Select fields and export CSV
  5. 05Human-readable table output

Use cases

  1. 01Find perpetual markets by volume or open interest
  2. 02Review leading traders over a chosen period
  3. 03Export screener or leaderboard results

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/nansen-ai/nansen-cli --skill nansen-perp

After installing, type/nansen-perpin Claude Code to confirm it loaded.

Details

From the project README

Perps (Hyperliquid)

No --chain flag needed — Hyperliquid only.

Screener

# Top perp markets by volume
nansen research perp screener --sort volume:desc --limit 20

# By open interest
nansen research perp screener --sort open_interest:desc --limit 10

Leaderboard

# Top perp traders by PnL
nansen research perp leaderboard --days 7 --limit 20

Flags

FlagPurpose
--sortSort field:direction (e.g. volume:desc)
--limitNumber of results
--daysLookback period (default 30)
--fieldsSelect specific fields
--tableHuman-readable table output
--format csvCSV export

Notes

  • For token-specific perp data, use nansen research token perp-trades --symbol BTC.
  • For wallet-specific perp data, use nansen research profiler perp-positions --address <addr>.
  • Portfolio perp exposure: nansen research portfolio defi --wallet <addr>.

Comments

Markdown supported