mcpField
N
nansen-wallet-analysis

nansen-wallet-analysis

github.com/nansen-aiData & databases14482 installsUpdated today
Repository

About nansen-wallet-analysis

A skill for examining a wallet with Nansen profiler commands. It helps users identify address labels, token balances and holdings, with perpetual-position data available for Hyperliquid.

Key features

  1. 01Look up wallet labels and categories
  2. 02Review token balances and USD values
  3. 03Retrieve Hyperliquid perpetual positions

Use cases

  1. 01Identify a wallet associated with a label
  2. 02Inspect a wallet’s token holdings
  3. 03Check open Hyperliquid perpetual positions

Install

Copy the command and run it in a terminal.

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

After installing, type/nansen-wallet-analysisin Claude Code to confirm it loaded.

Details

From the project README

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.

Comments

Markdown supported