Nansen Wallet Profiler

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

Security Scan

The skill's requirements and runtime instructions align with a CLI wrapper for Nansen's profiling API: it needs the nansen CLI and a NANSEN_API_KEY, and its SKILL.md only documents nansen commands — nothing appears disproportionate or unrelated.

Purpose & Capability

Name/description (wallet profiling) match the declared binary (nansen) and the single required env var (NANSEN_API_KEY). The node package nansen-cli that provides the nansen binary is a reasonable dependency for this purpose.

Instruction Scope

SKILL.md contains only concrete nansen CLI commands for profiling, tracing, batching, etc. It references an optional --file <path> for batch input (user-supplied file) and warns that trace makes many API calls. There are no instructions to read arbitrary system config or unrelated env vars or to transmit results to unknown endpoints beyond Nansen's API.

Install Mechanism

Install is a Node/npm package (nansen-cli) which creates the nansen binary. This is expected for a CLI-based skill but carries the usual npm-related risk: verify the package name and publisher before installing and consider running npm installs in a controlled environment.

Credentials

Only NANSEN_API_KEY is required and is declared as the primary credential — appropriate and proportionate for a service that queries Nansen APIs. No unrelated secrets or config paths are requested.

Persistence & Privilege

always:false and no special system config changes are requested. The skill does not request persistent system-wide privileges or access to other skills' configs.

Scan Findings in Context

[no_regex_findings] expected: This skill is instruction-only (SKILL.md) and has no code files for the regex scanner to analyze; no findings is expected in that case.

Assessment

This skill appears internally coherent, but take these practical precautions before installing: (1) verify the nansen-cli package is the official package/maintainer on npm or GitHub to avoid a malicious or typo-squatted package; (2) keep your NANSEN_API_KEY secret, use least-privilege/scoped keys if Nansen supports them, and rotate keys if needed; (3) be aware batch/trace commands can read a user-supplied file path and may make many API calls (cost/credit implications) — do not point it at sensitive local files; (4) run the npm install in an isolated/sandboxed environment if you are cautious; (5) monitor API usage/billing after first runs. If you need a stronger assurance, ask the skill publisher for the package repository or a checksum for the nansen-cli package before installing.

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