nansen-ai/nansen-cli

nansen-wallet-profiler

Wallet profiler — balance, PnL, labels, transactions, counterparties, related wallets, batch, trace, compare. Use when analysing a specific wallet address or comparing wallets.

First seen Mar 17, 2026

Installation

$ npx skills add nansen-ai/nansen-cli --skill nansen-wallet-profiler

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

Also in this package

Other skills from nansen-ai/nansen-cli · top by installs.

npx skills add nansen-ai/nansen-cli

Browse all from nansen-ai/nansen-cli

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 135
License LICENSE
Default branch main
Open issues 6
Status Active

Skill metadata

Parsed from SKILL.md frontmatter.

Allowed toolsBash(nansen:*)
Declared agents clawdbot
More metadata
openclaw
{"requires":{"env":["NANSEN_API_KEY"],"bins":["nansen"]},"primaryEnv":"NANSEN_API_KEY","install":{"0":"kind: node","package":"nansen-cli","bins":["nansen"]}}

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 3,054 B
  • docs SUMMARY.md 205 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 384 installs

SKILL.md

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

Flag Purpose
--address Wallet address (required)
--chain Required except for perps and search
--days Lookback period (default 30)
--limit Number of results
--include Batch fields: labels,balance,pnl
--depth Trace depth 1-5 (default 2)
--width Trace width — keep low to save credits
--fields Select specific fields
--table Human-readable table output
--format csv CSV export

Notes

  • pnl-summary has no pagination support (returns aggregate stats, not a list).
  • perp-positions has no pagination support.
  • labels supports pagination — --limit/--page are honoured and the response is {pagination: {page, perpage, islast_page}, data[]: {label, category, kind[]}}.
  • 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.