Agent skill

Nansen Perp Screener

by nansen-ai in nansen-ai/nansen-cli

What is the state of the Hyperliquid perp market?. An agent skill from nansen-ai/nansen-cli.

MITAuto-check passedBackend & APIs

Install Nansen Perp Screener

skills CLI
$ npx skills add nansen-ai/nansen-cli --skill nansen-perp-screener -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install nansen-ai/nansen-cli nansen-perp-screener --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/nansen-ai/nansen-cli.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/nansen-perp-screener .claude/skills/nansen-perp-screener && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
nansen-perp-screener
GitHub stars
139
Token cost
~1.3k tokens
SKILL.md length
367 words
Files
1
Skills in repo
32
Repo updated
First seen
Licence
MIT

At a glance

What is the state of the Hyperliquid perp market?. An agent skill from nansen-ai/nansen-cli.

  • Backend & APIs work in your project
  • SKILL.md covers Authentication, New Filters (ECINT-6680) and Combined Examples
  • Needs NANSEN_API_KEY

What it does

Nansen Perp Screener is an agent skill from nansen-ai/nansen-cli. What is the state of the Hyperliquid perp market? Top contracts by volume/OI, trader leaderboard, and SM perp activity.

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Backend & APIs. It works with Hyperliquid. The licence is MIT.

When your agent uses it

  • Backend & APIs work in your project

Example prompts

  • “/nansen-perp-screener”

Requirements

  • A credential in NANSEN_API_KEY
  • Pre-approved tools (allowed-tools): Bash(nansen:*)

What it can do on your machine

Read from SKILL.md and the folder at commit d097942. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash(nansen:*)

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • NANSEN_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Nansen Perp Screener loads about 1.3k tokens when it runs. Until then it costs about 35 tokens; SKILL.md has 367 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~35
When it runs · the whole SKILL.md, loaded when a task matches
~1.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from nansen-ai/nansen-cli at commit d097942, republished under its MIT licence (© nansen-ai). 367 words, ~1,273 tokens.

Download SKILL.mdSave it as .claude/skills/nansen-perp-screener/SKILL.md (or your agent's skills folder).
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.
allowed-tools
Bash(nansen:*)

Authentication

Browser login requests nansen:api for API-key-equivalent account API permissions; existing OAuth/MCP nansen:read semantics and separate wallet authorization are unchanged.

Before any research command or loop, require an explicitly selected API key or saved browser session. Run nansen auth status first. Its cached/unverified metadata does not prove credential validity or unlocked storage. Cached access-token expiry alone does not mean the session is unusable: the CLI normally renews a selected session automatically during an already-authorized research task, without another consent request or a separate account check. Stop on anonymous selection, invalid authentication state, blocked or uncertain renewal/cleanup, or an actual authentication failure, including rejected or expired refresh authority. Follow the CLI error guidance; use the free nansen account check when troubleshooting calls for it. Do not unset a failed key, erase a session or switch to anonymous access to retry.

Use nansen login for fresh browser approval within the documented platform scope, or configure a conventional API key. NANSEN_API_KEY overrides the saved session. OpenClaw's optional primaryEnv mapping preserves configured API-key injection; it is not a required-key gate or proof of authentication. Normal credits and entitlements apply. Login does not purchase credits. Browser login is available in CLI 2.0.0 within the macOS arm64 preview scope.

API keys and browser sessions use the same automatic x402 payment behavior: a supported HTTP 402 challenge can spend funds from the configured wallet under existing wallet authorization, payment policy and spending limits. Each call, including calls in loops, can incur a payment. Authentication, authorization and session-renewal failures never trigger payment; login verification and nansen account never pay automatically. Anonymous x402 remains available as a separate paid workflow requiring explicit user intent and payment setup. Do not run this research workflow anonymously or switch to anonymous access after authentication fails.

Show full SKILL.md (74 more words)Show less

Perp Market Scan

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

bash
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.

bash
# 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.

bash
# 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.

bash
# 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.

bash
# 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

bash
# 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

© nansen-ai, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/nansen-perp-screener of nansen-ai/nansen-cli.

Open the folder on GitHubat commit d097942

Compare with similar skills

Nansen Perp Screener next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Nansen Perp Screener compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Nansen Perp Screener this skillnansen-ai/nansen-cli139—~1.3kAutomated safety check: PassMIT
Deposit QrSuperior-Trade/superior-skills215—~1.1kAutomated safety check: PassMIT
Add NetworkOriginProtocol/origin-dollar153—~2.8kAutomated safety check: NotesMIT
CapacitrBankrBot/skills1.2k—~3kAutomated safety check: PassNone
Okx Dex Marketinternet-court/internet-court-skill6.6k1 repos~1.7kAutomated safety check: PassMIT
Okx Dapp Discoveryinternet-court/internet-court-skill6.6k1 repos~6.9kAutomated safety check: PassMIT

Similar skills

  • Deposit Qr

    Superior-Trade/superior-skills

    A skill your agent uses when a user needs a QR code or wallet payment URI to fund a Superior-managed EVM wallet on a specific chain before using Lighter, Polymarket, Hyperliquid, or other Superior…

    215 GitHub stars~1.1k tokensUpdated 1 mo ago
    Backend & APIsAuto-check passed
  • Add Network

    OriginProtocol/origin-dollar

    Checklist for adding a new EVM network (mainnet or testnet) to the origin-dollar repo.

    153 GitHub stars~2.8k tokensUpdated yesterday
    Backend & APIsAuto-check: notes
  • Capacitr

    BankrBot/skills

    Paste a URL or free text and get matched Polymarket / Hyperliquid / Deribit markets with Quotient edge scores.

    1.2k GitHub stars~3k tokensUpdated yesterday
    Backend & APIsAuto-check passed
  • Okx Dex Market

    internet-court/internet-court-skill

    HARD BLOCK — never use for prediction-market/Polymarket UpDown queries; route to okx-dapp-discovery when a named DApp (Polymarket/Aave/Hyperliquid/PancakeSwap/Morpho) appears with a timeframe, or…

    6.6k GitHub starsUsed in 1 repo~1.7k tokens
    Backend & APIsAuto-check passed
  • Okx Dapp Discovery

    internet-court/internet-court-skill

    Plugin router for 20 third-party DeFi protocols (Polymarket, Aave, Hyperliquid, PancakeSwap, Morpho, Raydium, Curve, Compound, Pendle, Lido, ether.fi, GMX, Kamino, Orca, Meteora, Clanker, pump.fun…

    6.6k GitHub starsUsed in 1 repo~6.9k tokens
    Backend & APIsAuto-check passed
  • Metengine Data Agent

    internet-court/internet-court-skill

    Real-time smart money analytics API for Polymarket prediction markets, Hyperliquid perpetual futures, and Meteora Solana LP/AMM pools.

    6.6k GitHub starsUsed in 1 repo~19k tokens
    Backend & APIsAuto-check passed

More from nansen-ai/nansen-cli

All 32 skills in this repo
  • Nansen Smart Money Tracker

    nansen-ai/nansen-cli

    Smart money tracking — netflow, trades, holdings, perp trades.

    139 GitHub starsUsed in 2 repos~1.1k tokens
    Auto-check passed
  • Nansen Token Research

    nansen-ai/nansen-cli

    Token deep dive — info, OHLCV, holders, flows, flow intelligence, who bought/sold, DEX trades, PnL, perp trades, perp positions, perp PnL leaderboard.

    139 GitHub starsUsed in 2 repos~1.2k tokens
    Auto-check passed
  • Nansen Wallet Profiler

    nansen-ai/nansen-cli

    Wallet profiler — balance, PnL, labels, transactions, counterparties, related wallets, batch, trace, compare.

    139 GitHub starsUsed in 2 repos~1.5k tokens
    Auto-check passed
  • Nansen Agent Guide

    nansen-ai/nansen-cli

    Routing guide -- when to use nansen agent (AI research) vs direct CLI data commands.

    139 GitHub stars~948 tokensUpdated 2 days ago
    Auto-check passed
  • Nansen Limit Orders

    nansen-ai/nansen-cli

    Guide users through native limit orders on Solana via nansen trade limit-order create|list|cancel|update, and the alert-based settlement-signal fallback for chains without native support.

    139 GitHub stars~2.5k tokensUpdated 2 days ago
    Auto-check passed
  • Nansen Smart Alerts

    nansen-ai/nansen-cli

    Manage smart alerts — list, create, update, toggle, delete. An agent skill from nansen-ai/nansen-cli.

    139 GitHub stars~1.6k tokensUpdated 2 days ago
    Auto-check passed

Works with

Categories

Questions about Nansen Perp Screener

What does Nansen Perp Screener do?

What is the state of the Hyperliquid perp market?. An agent skill from nansen-ai/nansen-cli. Nansen Perp Screener is an agent skill from nansen-ai/nansen-cli. What is the state of the Hyperliquid perp market?

When should I use Nansen Perp Screener?

Nansen Perp Screener fits situations like: backend & APIs work in your project.

How do I install Nansen Perp Screener in Claude Code?

Run `npx skills add nansen-ai/nansen-cli --skill nansen-perp-screener -a claude-code`. Or copy the skill folder (skills/nansen-perp-screener in nansen-ai/nansen-cli) into .claude/skills/nansen-perp-screener in your project. Claude Code loads it when a task matches its description.

How do I install Nansen Perp Screener in Codex?

Run `npx skills add nansen-ai/nansen-cli --skill nansen-perp-screener -a codex`. Or copy the skill folder (skills/nansen-perp-screener in nansen-ai/nansen-cli) into .agents/skills/nansen-perp-screener in your project. Codex loads it when a task matches its description.

Can I use Nansen Perp Screener in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add nansen-ai/nansen-cli --skill nansen-perp-screener -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/nansen-perp-screener, .gemini/skills/nansen-perp-screener, .github/skills/nansen-perp-screener and .opencode/skills/nansen-perp-screener in your project.

What does Nansen Perp Screener need to run?

Going by SKILL.md and its folder, Nansen Perp Screener needs credentials named NANSEN_API_KEY. Our summary lists: A credential in NANSEN_API_KEY. Its frontmatter pre-approves these tools: Bash(nansen:*).

Does Nansen Perp Screener access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Nansen Perp Screener safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Nansen Perp Screener use?

Nansen Perp Screener is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Nansen Perp Screener use?

About 1.3k tokens (SKILL.md is roughly 5.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Nansen Perp Screener?

Skills that share tags, products or a category with Nansen Perp Screener: Deposit Qr (Superior-Trade/superior-skills, 215 stars), Add Network (OriginProtocol/origin-dollar, 153 stars), Capacitr (BankrBot/skills, 1.2k stars) and Okx Dex Market (internet-court/internet-court-skill, 6.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Nansen Perp Screener?

nansen-ai (a GitHub organization) maintains it in nansen-ai/nansen-cli, which has 139 GitHub stars. The repository holds 32 skills in this directory. The repository was last updated on October 9, 2026.

Source: nansen-ai/nansen-cli on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.