Nansen Wallet Profiler

Name: Nansen Wallet Profiler
Author: nansen-ai

nansen-ai/nansen-cli

361 installs
127 repo stars
Updated August 4, 2026
nansen-ai/nansen-cli

nansen-wallet-profiler is an agent skill that wraps the Nansen CLI to profile blockchain wallet addresses with balance, PnL, labels, transactions, counterparties, trace, batch, and compare output for developers who need

About

nansen-wallet-profiler is an AI agent skill for the nansen-cli npm package that teaches agents to run `nansen research profiler` subcommands against Ethereum and other chains. The skill documents balance, labels, PnL, transactions, counterparties, related wallets, batch, trace, and compare workflows, requiring `--address` and `--chain` on most calls and returning structured JSON (with optional table or CSV export). Developers reach for nansen-wallet-profiler when investigating a wallet address, comparing cohorts, or tracing fund flows without clicking through Nansen’s web UI. Setup needs the `nansen` binary, Node.js v18+, and a `NANSEN_API_KEY` from Nansen Pro or x402 pay-per-call.

Wallet labels
On-chain profiling
Holder analysis
Flow summaries
Nansen CLI

Nansen Wallet Profiler by the numbers

361 all-time installs (skills.sh)
+4 installs in the week ending Aug 4, 2026 (Skillselion tracking)
Ranked #45 of 479 Web3 & Blockchain skills by installs in the Skillselion catalog
Data as of Aug 5, 2026 (Skillselion catalog sync)

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

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

[![Listed on Skillselion](https://skillselion.com/badge/skills/nansen-ai/nansen-cli/nansen-wallet-profiler.svg)](https://skillselion.com/skills/nansen-ai/nansen-cli/nansen-wallet-profiler)

Installs	361
repo stars	★ 127
Last updated	August 4, 2026
Repository	nansen-ai/nansen-cli ↗

How do you profile a blockchain wallet from the terminal?

Profile blockchain wallets via Nansen CLI to summarize holdings, labels, flows, and behavior for due diligence or trading research.

Who is it for?

Developers and quant researchers who already use Nansen and need repeatable wallet due diligence, whale tracking, or counterparty tracing from CLI or AI agents.

Skip if: Teams without a Nansen API key or x402 wallet who only need generic block explorer lookups without labeled smart-money intelligence.

When should I use this skill?

A developer or agent supplies a wallet address or cohort and asks for onchain holdings, labels, PnL, counterparties, fund-flow trace, or wallet-to-wallet comparison.

What you get

Structured JSON wallet profiles with balances, PnL summaries, Nansen labels, transaction history, counterparty lists, trace graphs, and batch comparison tables.

JSON wallet profile reports
CSV or table exports of holdings and flows
Batch comparison output for wallet cohorts

By the numbers

Documents 9 profiler capabilities: balance, PnL, labels, transactions, counterparties, related wallets, batch, trace, co
Trace command supports depth 1-5 hops with default depth 2
Default `--days` lookback period is 30 for time-bounded PnL and activity queries

Files

SKILL.mdMarkdownGitHub ↗

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.

Related skills

Solidity SecurityCatch and fix critical Solidity vulnerabilities like reentrancy before deploying smart contracts.13k38.4k

Extension Http OutcallsEnable their Internet Computer backend canister to make secure HTTP GET and POST requests to external APIs.10.3k

Okx Dapp DiscoveryCorrectly route Chinese-language DeFi and on-chain queries to the right protocol plugins inside an agent workflow.9.5k315

Okx Growth CompetitionGuide users through OKX OnchainOS competition reward status checks, atomic claims, and post-win contact collection via the onchainos CLI.9.1k315

Okx Agent Payments ProtocolLet their AI agent create and fulfill on-chain payment links without leaving the coding session.8.7k315

Query Token InfoGive your coding agent a Node CLI to search Binance tokens and pull metadata while you build crypto or DeFi features.6.1k946

How it compares

Choose nansen-wallet-profiler when labeled Nansen intelligence, multi-hop tracing, and batch wallet comparison matter; use a block explorer CLI when you only need raw balances and unlabeled transaction lists.

FAQ

What commands does nansen-wallet-profiler use?

nansen-wallet-profiler drives `nansen research profiler <sub>` subcommands such as balance, labels, pnl, transactions, counterparties, related-wallets, batch, trace, and compare. Most calls require `--address` and `--chain` flags and return structured JSON from the Nansen API.

What do you need to run nansen-wallet-profiler?

nansen-wallet-profiler requires the global `nansen` binary from the nansen-cli npm package (Node.js v18+), plus authentication via `NANSEN_API_KEY` or `nansen login`. Agents invoke profiler commands through Bash with `nansen:*` permissions.

How does wallet tracing work in nansen-wallet-profiler?

nansen-wallet-profiler uses `nansen research profiler trace` with `--depth` from 1 to 5 hops (default 2) and a `--width` cap to limit counterparty expansion. Trace follows fund flows across labeled addresses and consumes more Nansen API credits at higher depth or width.

Web3 & Blockchainanalyticspipelines