nansen-smart-money-tracker

--- name: nansen-smart-money-tracker description: Smart money tracking — netflow, trades, holdings, perp trades. Use when finding what smart money wallets are buying/selling or tracking whale activity. metadata: openclaw: requires: bins: - nansen primaryEnv: NANSEN_API_KEY install: - kind: node package: nansen-cli bins: [nansen] 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 enabled in production within the [documented platform scope](https://github.com/nansen-ai/nansen-cli/blob/main/docs/browser-login.md#preview-platform-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. # Smart Money All commands: `nansen research smart-money <sub> [options]` ## Subcommands ```bash # Netflow — what tokens are smart money accumulating? nansen research smart-money netflow --chain solana --limit 10 # DEX trades — real-time spot trades by smart money nansen research smart-money dex-trades --chain solana --labels "Smart Trader" --limit 20 # Holdings — aggregated SM portfolio nansen research smart-money holdings --chain solana --limit 10 # Perp trades — Hyperliquid only (no --chain needed) nansen research smart-money perp-trades --limit 10 ``` ## Labels Filter by smart money category with `--labels`: | Label | Use case | |-------|----------| | `Smart Trader` | Top performers across all time windows | | `Smart HL Perps Trader` | Top Hyperliquid perp traders | | `30D Smart Trader` | Top 30 days (`Smart Trader` already includes it) | | `90D Smart Trader` | Top 90 days (`Smart Trader` already includes it) | | `180D Smart Trader` | Top 180 days (`Smart Trader` already includes it) | ```bash nansen research smart-money netflow --chain solana --labels "Smart Trader" --limit 10 ``` `Fund` is no longer a Smart Money label: Fund wallets left Smart Money on 2026-09-09, so `--labels "Fund"` matches no wallets in current Smart Money data. ## Flags | Flag | Purpose | |------|---------| | `--chain` | Required for netflow/dex-trades/holdings | | `--labels` | Filter by SM label (quote multi-word values) | | `--limit` | Number of results | | `--sort` | Sort field:direction (e.g. `value_usd:desc`) | | `--fields` | Select specific fields | | `--table` | Human-readable table output | | `--format csv` | CSV export | ## Notes - `perp-trades` is Hyperliquid-only. No `--chain` flag. - For a time-series view of SM positions: `nansen research smart-money historical-holdings --chain <chain> --days 30`

存档时间线

版本索引永久保留；内容副本只保留最新 1 份，更早版本仅留索引与哈希（存档时间线的证据链不会因此断裂）。

下载存档内容副本

相关资产