Agent skill

Nansen Wallet Profiler

by nansen-ai in nansen-ai/nansen-cli

Wallet profiler — balance, PnL, labels, transactions, counterparties, related wallets, batch, trace, compare.

MITAuto-check passedDevelopment

Install Nansen Wallet Profiler

skills CLI
$ npx skills add nansen-ai/nansen-cli --skill nansen-wallet-profiler -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install nansen-ai/nansen-cli nansen-wallet-profiler --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/nansen-ai/nansen-cli.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/nansen-wallet-profiler .claude/skills/nansen-wallet-profiler && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
nansen-wallet-profiler
GitHub stars
139
Used in
2 other repos
Token cost
~1.5k tokens
SKILL.md length
443 words
Files
1
Skills in repo
32
Repo updated
First seen
Licence
MIT

At a glance

Wallet profiler — balance, PnL, labels, transactions, counterparties, related wallets, batch, trace, compare.

  • Analysing a specific wallet address
  • SKILL.md covers Authentication, Balance & Identity, PnL and Transactions & History, plus 5 more sections
  • Needs NANSEN_API_KEY
  • Comparing wallets

What it does

Nansen Wallet Profiler is an agent skill from nansen-ai/nansen-cli. Wallet profiler — balance, PnL, labels, transactions, counterparties, related wallets, batch, trace, compare. Use when analysing a specific wallet address or comparing wallets.

Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Performance optimization. The licence is MIT.

When your agent uses it

  • Analysing a specific wallet address
  • Comparing wallets

Example prompts

  • “/nansen-wallet-profiler”

Requirements

  • A credential in NANSEN_API_KEY
  • Pre-approved tools (allowed-tools): Bash(nansen:*)

What it can do on your machine

Read from SKILL.md and the folder at commit d097942. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash(nansen:*)

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • NANSEN_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Nansen Wallet Profiler loads about 1.5k tokens when it runs. Until then it costs about 50 tokens; SKILL.md has 443 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~50
When it runs · the whole SKILL.md, loaded when a task matches
~1.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from nansen-ai/nansen-cli at commit d097942, republished under its MIT licence (© nansen-ai). 443 words, ~1,535 tokens.

Download SKILL.mdSave it as .claude/skills/nansen-wallet-profiler/SKILL.md (or your agent's skills folder).
name
nansen-wallet-profiler
description
Wallet profiler — balance, PnL, labels, transactions, counterparties, related wallets, batch, trace, compare. Use when analysing a specific wallet address or comparing wallets.
allowed-tools
Bash(nansen:*)

Authentication

Browser login requests nansen:api for API-key-equivalent account API permissions; existing OAuth/MCP nansen:read semantics and separate wallet authorization are unchanged.

Before any research command or loop, require an explicitly selected API key or saved browser session. Run nansen auth status first. Its cached/unverified metadata does not prove credential validity or unlocked storage. Cached access-token expiry alone does not mean the session is unusable: the CLI normally renews a selected session automatically during an already-authorized research task, without another consent request or a separate account check. Stop on anonymous selection, invalid authentication state, blocked or uncertain renewal/cleanup, or an actual authentication failure, including rejected or expired refresh authority. Follow the CLI error guidance; use the free nansen account check when troubleshooting calls for it. Do not unset a failed key, erase a session or switch to anonymous access to retry.

Use nansen login for fresh browser approval within the documented platform scope, or configure a conventional API key. NANSEN_API_KEY overrides the saved session. OpenClaw's optional primaryEnv mapping preserves configured API-key injection; it is not a required-key gate or proof of authentication. Normal credits and entitlements apply. Login does not purchase credits. Browser login is available in CLI 2.0.0 within the macOS arm64 preview scope.

API keys and browser sessions use the same automatic x402 payment behavior: a supported HTTP 402 challenge can spend funds from the configured wallet under existing wallet authorization, payment policy and spending limits. Each call, including calls in loops, can incur a payment. Authentication, authorization and session-renewal failures never trigger payment; login verification and nansen account never pay automatically. Anonymous x402 remains available as a separate paid workflow requiring explicit user intent and payment setup. Do not run this research workflow anonymously or switch to anonymous access after authentication fails.

Show full SKILL.md (150 more words)Show less

Wallet Profiler

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

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

Balance & Identity

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

PnL

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

Transactions & History

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

Relationships

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

# Counterparties for up to 10 wallets in one call (max --days 90).
# Results are not aggregated — every row carries the wallet_address it belongs to.
# One ecosystem per request: EVM and Solana addresses cannot be mixed; `all` auto-detects it.
# --chain also takes any single chain the profiler serves, EVM or not: arbitrum, arc,
# avalanche, base, bitcoin, bnb (`bsc` is accepted too), ethereum, hyperevm, injective,
# iotaevm, linea, mantle, mantra, monad, near, optimism, plasma, polygon, robinhood, sei,
# solana, sonic, starknet, sui, ton, tron.
# Rows come back as contiguous per-wallet blocks ordered by wallet address, so a small page
# holds one wallet only — raise --limit and page with --page N to reach later wallets.
nansen research profiler counterparties-batch --addresses "0xabc,0xdef" --days 30 --limit 50

Perps (no --chain)

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

Batch, Trace & Compare

bash
# 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
--addressesComma-separated wallets for batch, compare, counterparties-batch
--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 supports pagination — --limit/--page are honoured and the response is {pagination: {page, per_page, is_last_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.

© nansen-ai, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/nansen-wallet-profiler of nansen-ai/nansen-cli.

Open the folder on GitHubat commit d097942

Used in 2 other repositories

We found 3 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 2 other GitHub owners. This page covers the copy in nansen-ai/nansen-cli, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Nansen Wallet Profiler next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Nansen Wallet Profiler compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Nansen Wallet Profiler this skillnansen-ai/nansen-cli1392 repos~1.5kAutomated safety check: PassMIT
Code Review ChecklistshareAI-lab/learn-claude-code78k4 repos~1.1kAutomated safety check: PassMIT
LLM Torch Profiler Analysissgl-project/sglang37k2 repos~6.4kAutomated safety check: PassApache-2.0
Pycrazyguitar/pysheeet8.2k—~886Automated safety check: PassMIT
Cmux Debugging Guidemanaflow-ai/cmux28k1 repos~1.1kAutomated safety check: PassCustom licence
Analyzing .NET Performancedotnet/skills5.6k3 repos~3.1kAutomated safety check: PassMIT

Similar skills

  • Code Review Checklist

    shareAI-lab/learn-claude-code

    Reviews code against a five-part checklist covering security, correctness, performance, maintainability and testing, and reports findings in a fixed format.

    78k GitHub starsUsed in 4 repos~1.1k tokens
    DevelopmentAuto-check passed
  • LLM Torch Profiler Analysis

    sgl-project/sglang

    Unified LLM torch-profiler triage skill for sglang, vllm, TensorRT-LLM, and TokenSpeed.

    37k GitHub starsUsed in 2 repos~6.4k tokens
    DevelopmentAuto-check passed
  • Py

    crazyguitar/pysheeet

    Comprehensive Python programming reference covering syntax, concurrency, networking, databases, ML/LLM development, and HPC.

    8.2k GitHub stars~886 tokensUpdated 4 days ago
    DevelopmentAuto-check passed
  • Cmux Debugging Guide

    manaflow-ai/cmux

    Covers debug logging, the Debug menu, profiling rules and runtime pitfalls for working on the cmux macOS terminal app.

    28k GitHub starsUsed in 1 repo~1.1k tokens
    DevelopmentAuto-check passed
  • Official

    Scans C# and .NET code for about 50 performance anti-patterns and reports prioritized findings with concrete fixes, at a scan depth you choose.

    5.6k GitHub starsUsed in 3 repos~3.1k tokens
    DevelopmentAuto-check passed
  • Analyzes V8, Chrome and Electron .heapsnapshot files with Node scripts to find memory leaks, detached DOM nodes and the retainer paths that keep objects alive.

    9.3k GitHub stars~875 tokensUpdated yesterday
    DevelopmentAuto-check passed

More from nansen-ai/nansen-cli

All 32 skills in this repo
  • Nansen Smart Money Tracker

    nansen-ai/nansen-cli

    Smart money tracking — netflow, trades, holdings, perp trades.

    139 GitHub starsUsed in 2 repos~1.1k tokens
    Auto-check passed
  • Nansen Token Research

    nansen-ai/nansen-cli

    Token deep dive — info, OHLCV, holders, flows, flow intelligence, who bought/sold, DEX trades, PnL, perp trades, perp positions, perp PnL leaderboard.

    139 GitHub starsUsed in 2 repos~1.2k tokens
    Auto-check passed
  • Nansen Agent Guide

    nansen-ai/nansen-cli

    Routing guide -- when to use nansen agent (AI research) vs direct CLI data commands.

    139 GitHub stars~948 tokensUpdated 2 days ago
    Auto-check passed
  • Nansen Limit Orders

    nansen-ai/nansen-cli

    Guide users through native limit orders on Solana via nansen trade limit-order create|list|cancel|update, and the alert-based settlement-signal fallback for chains without native support.

    139 GitHub stars~2.5k tokensUpdated 2 days ago
    Auto-check passed
  • Nansen Smart Alerts

    nansen-ai/nansen-cli

    Manage smart alerts — list, create, update, toggle, delete. An agent skill from nansen-ai/nansen-cli.

    139 GitHub stars~1.6k tokensUpdated 2 days ago
    Auto-check passed
  • Nansen General Search

    nansen-ai/nansen-cli

    Search for tokens or entities by name. An agent skill from nansen-ai/nansen-cli.

    139 GitHub starsUsed in 2 repos~776 tokens
    Auto-check passed

Categories

Questions about Nansen Wallet Profiler

What does Nansen Wallet Profiler do?

Wallet profiler — balance, PnL, labels, transactions, counterparties, related wallets, batch, trace, compare. Nansen Wallet Profiler is an agent skill from nansen-ai/nansen-cli. Wallet profiler — balance, PnL, labels, transactions, counterparties, related wallets, batch, trace, compare.

When should I use Nansen Wallet Profiler?

Nansen Wallet Profiler fits situations like: analysing a specific wallet address; comparing wallets.

How do I install Nansen Wallet Profiler in Claude Code?

Run `npx skills add nansen-ai/nansen-cli --skill nansen-wallet-profiler -a claude-code`. Or copy the skill folder (skills/nansen-wallet-profiler in nansen-ai/nansen-cli) into .claude/skills/nansen-wallet-profiler in your project. Claude Code loads it when a task matches its description.

How do I install Nansen Wallet Profiler in Codex?

Run `npx skills add nansen-ai/nansen-cli --skill nansen-wallet-profiler -a codex`. Or copy the skill folder (skills/nansen-wallet-profiler in nansen-ai/nansen-cli) into .agents/skills/nansen-wallet-profiler in your project. Codex loads it when a task matches its description.

Can I use Nansen Wallet Profiler in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add nansen-ai/nansen-cli --skill nansen-wallet-profiler -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/nansen-wallet-profiler, .gemini/skills/nansen-wallet-profiler, .github/skills/nansen-wallet-profiler and .opencode/skills/nansen-wallet-profiler in your project.

What does Nansen Wallet Profiler need to run?

Going by SKILL.md and its folder, Nansen Wallet Profiler needs credentials named NANSEN_API_KEY. Our summary lists: A credential in NANSEN_API_KEY. Its frontmatter pre-approves these tools: Bash(nansen:*).

Does Nansen Wallet Profiler access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Nansen Wallet Profiler safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Nansen Wallet Profiler use?

Nansen Wallet Profiler is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Nansen Wallet Profiler use?

About 1.5k tokens (SKILL.md is roughly 6.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Nansen Wallet Profiler?

Skills that share tags, products or a category with Nansen Wallet Profiler: Code Review Checklist (shareAI-lab/learn-claude-code, 78k stars), LLM Torch Profiler Analysis (sgl-project/sglang, 37k stars), Py (crazyguitar/pysheeet, 8.2k stars) and Cmux Debugging Guide (manaflow-ai/cmux, 28k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Nansen Wallet Profiler?

nansen-ai (a GitHub organization) maintains it in nansen-ai/nansen-cli, which has 139 GitHub stars. The repository holds 32 skills in this directory. The repository was last updated on October 9, 2026.

Source: nansen-ai/nansen-cli on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.