Token deep dive — info, OHLCV, holders, flows, flow intelligence, who bought/sold, DEX trades, PnL, perp trades, perp positions, perp PnL leaderboard. Use when researching a specific token in depth.

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. Token Deep Dive All commands: nansen research token <sub [options] chain required for spot endpoints. Use token <address for token specific endpoints. Info & Price Timeframes: 1m , 5m , 15m , 30m , 1h , 2h , 4h , 1d , 1w , 1M Holders Flows flow intelligence breaks down by label: whales, smart traders, exchanges, fresh wallets, public figures. DEX Trades PnL Perps (no chain) Flags Flag Purpose chain Required for spot endpoints (ethereum, solana, base, etc.) token Token address (alias: token address ) symbol Token symbol for perp endpoints (e.g. BTC) timeframe OHLCV interval smart money Filter to SM wallets only (holders) days Lookback period (default 30) sort Sort field:direction (e.g. total pnl usd:desc ) fields Select specific fields table Human readable table output format csv CSV export Notes Perp endpoints use symbol (e.g. BTC), not token . holders smart money returns UNSUPPORTED FILTER for tokens without SM tracking. flow intelligence may return all zero flows for illiquid tokens.

nansen-token-research