mcpField
N
nansen-token-forensics

nansen-token-forensics

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

About nansen-token-forensics

nansen-token-forensics is a nansen-cli skill for tracing token transfers and identifying where tokens move and who sends or receives them. Address labels and transfer values help assess exchange inflows and fresh-wallet activity.

Key features

  1. 01Query token transfers over a chosen period
  2. 02Inspect sender and recipient labels
  3. 03View transfer amounts and USD values

Use cases

  1. 01Track large transfers to exchange addresses
  2. 02Assess fresh-wallet inflows and possible sell pressure

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/nansen-ai/nansen-cli --skill nansen-token-forensics

After installing, type/nansen-token-forensicsin Claude Code to confirm it loaded.

Details

From the project README

Token Forensics

Answers: "Where is this token moving? Who is sending it and where?"

TOKEN=<address> CHAIN=ethereum
# Examples: UNI on ethereum (0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984)
#           BONK on solana (DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263)
# Note: token flows does NOT support stablecoins (USDC, USDT, etc.) — use non-stablecoin tokens

nansen research token transfers --token $TOKEN --chain $CHAIN --days 7 --limit 20
# → from_address_label, to_address_label, transfer_amount, transfer_value_usd

nansen research token flows --token $TOKEN --chain $CHAIN --days 7 --limit 20
# → date, price_usd, holders_count, total_inflows_count, total_outflows_count
# ⚠ Returns HTTP 422 for stablecoins — skip this command if TOKEN is a stablecoin

nansen research token flow-intelligence --token $TOKEN --chain $CHAIN
# → net_flow_usd per label: smart_trader, whale, exchange, fresh_wallets, public_figure

Rising exchange_net_flow + large transfers to exchange addresses = potential sell pressure. Fresh wallet inflows may signal new interest or wash trading.

Comments

Markdown supported