mcpField
N
nansen-perp-trader

nansen-perp-trader

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

About nansen-perp-trader

nansen-perp-trader is a skill for examining a perpetual trader’s positions and track record using Nansen research commands. It cross-references trades and positions to show whether the trader is scaling in or out, with leaderboard context for relative standing.

Key features

  1. 01Look up trader labels and categories
  2. 02Inspect perpetual positions and margin summaries
  3. 03Compare trades with positions
  4. 04Check leaderboard standing

Use cases

  1. 01Review a trader’s current positions
  2. 02Assess whether a trader is scaling in or out

Install

Copy the command and run it in a terminal.

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

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

Details

From the project README

Perp Trader

Answers: "What is this perp trader doing? What are their positions and track record?"

ADDR=<address>

nansen research profiler labels --address $ADDR --chain ethereum
# → label, category (identity, SM labels)

nansen research profiler perp-positions --address $ADDR
# → asset_positions, margin_summary_account_value_usd, margin_summary_total_margin_used_usd

nansen research profiler perp-trades --address $ADDR --days 7 --limit 20
# → timestamp, token_symbol, side, action (Open/Close/Reduce), price, size, value_usd, closed_pnl, fee_usd

nansen research perp leaderboard --days 7 --limit 50
# → trader_address, total_pnl, roi, account_value (check if ADDR appears)

Cross-reference perp-trades with perp-positions to see if the trader is scaling in/out. Leaderboard shows relative standing.

Comments

Markdown supported