nansen-smart-money-tracker

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.

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

# 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)

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