mcpField
N
nansen-profiler

nansen-profiler

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

About nansen-profiler

nansen-profiler is a skill for using Nansen CLI commands to inspect blockchain wallets. It covers balances, labels, PnL, transactions, wallet relationships, perpetual trades, and batch or multi-hop tracing.

Key features

  1. 01Inspect balances and wallet labels
  2. 02Review PnL and transaction history
  3. 03Find related wallets and counterparties
  4. 04Query perpetual positions and trades
  5. 05Batch profiles and trace counterparties
  6. 06Export selected results as CSV

Use cases

  1. 01Check a wallet’s holdings and labels
  2. 02Review wallet PnL over a chosen period
  3. 03Trace counterparties across multiple hops

Install

Copy the command and run it in a terminal.

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

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

Details

From the project README

Wallet Profiler

All commands: nansen research profiler <sub> [options]

--address and --chain required for most commands.

Balance & Identity

nansen research profiler balance --address <addr> --chain ethereum
nansen research profiler labels --address <addr> --chain ethereum
nansen research profiler search --query "Vitalik"

PnL

nansen research profiler pnl --address <addr> --chain ethereum --days 30
nansen research profiler pnl-summary --address <addr> --chain ethereum

Transactions & History

nansen research profiler transactions --address <addr> --chain ethereum --limit 20
nansen research profiler historical-balances --address <addr> --chain solana --days 30

Relationships

nansen research profiler related-wallets --address <addr> --chain ethereum
nansen research profiler counterparties --address <addr> --chain ethereum --days 30

Perps (no --chain)

nansen research profiler perp-positions --address <addr>
nansen research profiler perp-trades --address <addr> --days 7

Batch, Trace & Compare

# Batch — profile multiple wallets at once
nansen research profiler batch \
  --addresses "0xabc,0xdef" --chain ethereum \
  --include labels,balance,pnl

# Trace — BFS multi-hop counterparty trace (makes N*width API calls)
nansen research profiler trace --address <addr> --chain ethereum --depth 2 --width 5

# Compare — shared counterparties and tokens between two wallets
nansen research profiler compare --addresses "0xabc,0xdef" --chain ethereum

Flags

FlagPurpose
--addressWallet address (required)
--chainRequired except for perps and search
--daysLookback period (default 30)
--limitNumber of results
--includeBatch fields: labels,balance,pnl
--depthTrace depth 1-5 (default 2)
--widthTrace width — keep low to save credits
--fieldsSelect specific fields
--tableHuman-readable table output
--format csvCSV export

Notes

  • pnl-summary has no pagination support (returns aggregate stats, not a list).
  • perp-positions has no pagination support.
  • labels has no pagination support — the API ignores per_page and always returns all labels for the address. --limit is not available for this sub-command.
  • transactions caps at per_page=100 (API limit).
  • trace makes many API calls — use --width conservatively.
  • batch accepts --file <path> with one address per line as alternative to --addresses.

Comments

Markdown supported