
Nansen Token Transfer Analysis
- 348 installs
- 127 repo stars
- Updated August 4, 2026
- nansen-ai/nansen-cli
nansen-token-transfer-analysis is an agent skill that queries the Nansen CLI to trace token transfer flows, wallet labels, and flow intelligence for developers who investigate on-chain whale activity and liquidity shifts
About
nansen-token-transfer-analysis is an agent skill bundled with nansen-ai/nansen-cli that runs Bash commands against the nansen binary to forensically analyze where a token is moving and why on live chains. After setting TOKEN and CHAIN environment variables and a NANSEN_API_KEY, the skill calls nansen research token transfers, token flows, and token flow-intelligence to surface from_address_label, to_address_label, transfer_value_usd, holder counts, and net_flow_usd breakdowns by labels such as smart_trader, whale, exchange, and fresh_wallets. Developers reach for nansen-token-transfer-analysis when spotting whale moves, suspicious routing, exchange sell pressure, or fresh-wallet inflows on Ethereum or Solana tokens like UNI or BONK. The skill notes that token flows returns HTTP 422 for stablecoins and directs analysts to skip that command for USDC or USDT while still using transfer tables. Install nansen-cli via npm, expose the nansen binary, and invoke allowed-tools Bash(nansen:*) when investigating on-chain activity worth alerting or deeper investigation.
- Transfer flows
- Whale tracking
- On-chain monitoring
- Nansen CLI
- Anomaly detection
Nansen Token Transfer Analysis by the numbers
- 348 all-time installs (skills.sh)
- +3 installs in the week ending Aug 4, 2026 (Skillselion tracking)
- Ranked #54 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-token-transfer-analysisAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 348 |
|---|---|
| repo stars | ★ 127 |
| Last updated | August 4, 2026 |
| Repository | nansen-ai/nansen-cli ↗ |
Where is this token moving on-chain?
Analyze token transfer flows via Nansen CLI to spot whale moves, suspicious routing, liquidity shifts, and ongoing on-chain activity worth alerting or investigating.
Who is it for?
Web3 developers and analysts who already have a NANSEN_API_KEY and need labeled transfer forensics on Ethereum or Solana tokens.
Skip if: Developers analyzing stablecoin flows with token flows, which returns HTTP 422 for USDC and USDT on supported chains.
When should I use this skill?
User asks where a token is moving, who is sending it, whale transfer alerts, or on-chain flow intelligence for a contract address.
What you get
CLI tables of labeled transfers, daily flow trends, and net_flow_usd intelligence by wallet category for a given token and chain.
- Labeled transfer tables
- Daily flow trend output
- Net flow intelligence by wallet category
By the numbers
- Uses three nansen research subcommands: token transfers, token flows, and token flow-intelligence
- Example CLI queries default to --days 7 and --limit 20 result rows
Files
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_figureRising exchange_net_flow + large transfers to exchange addresses = potential sell pressure. Fresh wallet inflows may signal new interest or wash trading.
Related skills
How it compares
Pick nansen-token-transfer-analysis when you need labeled wallet transfer forensics via Nansen CLI rather than generic block explorer transaction lists.
FAQ
What environment does nansen-token-transfer-analysis require?
nansen-token-transfer-analysis requires NANSEN_API_KEY set as primaryEnv, the nansen CLI binary installed from the nansen-cli npm package, and Bash access to run nansen research commands.
Can nansen-token-transfer-analysis analyze USDC flows?
nansen-token-transfer-analysis can run token transfers for stablecoins, but nansen research token flows returns HTTP 422 for stablecoins like USDC and USDT, so skip that command for stablecoin tokens.