Nansen Wallet Deep Dive

Who is this wallet and what have they been doing? Identity labels, balance, PnL summary, recent transactions, perp positions, and counterparties.

Security Scan

The skill's requested binary (nansen), API key, and npm install match its stated purpose of running Nansen wallet profiler commands; nothing requested appears unrelated or excessive.

Purpose & Capability

Name/description ask for wallet profiling and the skill requires the nansen CLI and a NANSEN_API_KEY, which are proportional and expected for Nansen API usage.

Instruction Scope

SKILL.md contains concrete nansen CLI commands that only reference an address and chain; it does not instruct reading unrelated files or other environment variables. The instructions are narrowly scoped to querying Nansen profiler endpoints.

Install Mechanism

Install is a node/npm package (nansen-cli) that produces the nansen binary. This is a common install method but carries the usual npm risks (runs third-party code during install); verify package provenance/version before installing.

Credentials

Only NANSEN_API_KEY is required and declared as the primary credential. That is appropriate for a skill that calls Nansen APIs; no unrelated secrets or config paths are requested.

Persistence & Privilege

Skill is not forced-always, does not request system config changes, and only uses the normal autonomous-invocation default. It does not demand elevated or cross-skill privileges.

Assessment

This skill appears coherent with its purpose. Before installing: (1) confirm you want to install an npm package (nansen-cli) and verify the package name/version/maintainer on the npm registry; (2) use a least-privilege NANSEN_API_KEY (read-only if available) and avoid using any account-scoped or billing-sensitive key you don't trust; (3) be aware queries reveal on-chain activity for addresses you analyze (sensitive data); (4) prefer installing in an isolated environment (container or VM) if you have security concerns. If you need higher assurance, ask the author for a signed release link or a pinned package version and changelog.

Wallet Analysis

Answers: "Who is this wallet and what have they been doing?"

ADDR=<address> CHAIN=ethereum

nansen research profiler labels --address $ADDR --chain $CHAIN
# → label, category (e.g. "Smart Trader", "Fund", "Public Figure", ENS names)

nansen research profiler balance --address $ADDR --chain $CHAIN
# → token_symbol, token_name, token_amount, price_usd, value_usd per holding

nansen research profiler pnl-summary --address $ADDR --chain $CHAIN --days 30
# → realized_pnl_usd, realized_pnl_percent, win_rate, traded_token_count, traded_times, top5_tokens

nansen research profiler transactions --address $ADDR --chain $CHAIN --limit 20
# → block_timestamp, method, tokens_sent, tokens_received, volume_usd, source_type

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

nansen research profiler counterparties --address $ADDR --chain $CHAIN --days 30
# → counterparty_address, counterparty_address_label, interaction_count, total_volume_usd, volume_in/out_usd

perp-positions returns Hyperliquid data — returns empty if the wallet has no open perps.