nansen-token-research
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.
Best use case
nansen-token-research is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
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.
Teams using nansen-token-research should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/nansen-token-research/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How nansen-token-research Compares
| Feature / Agent | nansen-token-research | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
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.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
# Token Deep Dive All commands: `nansen research token <sub> [options]` `--chain` required for spot endpoints. Use `--token <address>` for token-specific endpoints. ## Info & Price ```bash nansen research token info --token <addr> --chain solana nansen research token ohlcv --token <addr> --chain solana --timeframe 1h ``` Timeframes: `1m`, `5m`, `15m`, `30m`, `1h`, `2h`, `4h`, `1d`, `1w`, `1M` ## Holders ```bash nansen research token holders --token <addr> --chain solana nansen research token holders --token <addr> --chain solana --smart-money ``` ## Flows ```bash nansen research token flows --token <addr> --chain solana --days 7 nansen research token flow-intelligence --token <addr> --chain solana nansen research token who-bought-sold --token <addr> --chain solana ``` `flow-intelligence` breaks down by label: whales, smart traders, exchanges, fresh wallets, public figures. ## DEX Trades ```bash nansen research token dex-trades --token <addr> --chain solana --limit 20 ``` ## PnL ```bash nansen research token pnl --token <addr> --chain solana --sort total_pnl_usd:desc ``` ## Perps (no --chain) ```bash nansen research token perp-trades --symbol ETH --days 7 nansen research token perp-positions --symbol BTC nansen research token perp-pnl-leaderboard --symbol SOL ``` ## 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.
Related Skills
okx-dex-token
Use this skill for token-level data: cluster overview, search tokens, trending/hot tokens (热门, 代币榜单), liquidity pools, holder distribution (whale/巨鲸, sniper, bundler percent), token safety and honeypot risk (貔貅盘, 'is this token a honeypot', 'is this safe to buy', 'rugged?', 'can I sell this'), who created a token, recent buy/sell activity, top profit addresses, trade history by wallet type, or holder cluster analysis (持仓集中度, rug pull probability/跑路风险, new wallet percentage/新钱包持仓比例, suspicious holding percentage/可疑持仓%, bundle hold percent, holder clusters, 'are top holders in same cluster'). Invoke on user intent; address can be provided after. Do NOT use for market-wide whale/signal tracking — use okx-dex-signal. Do NOT use for meme/pump.fun launch scanning, dev reputation, or bundle detection — use okx-dex-trenches. Do NOT use for personal DEX trade history or price charts — use okx-dex-market.
query-token-info
Query token details by keyword, contract address, or chain. Search tokens, get metadata and social links, retrieve real-time market data (price, price trend, volume, holders, liquidity), and fetch K-Line candlestick charts. Use this skill when users search tokens, check token prices, view market data, or request kline/candlestick charts.
query-token-audit
Query token security audit to detect scams, honeypots, and malicious contracts before trading. Returns comprehensive security analysis including contract risks, trading risks, and scam detection. Use when users ask "is this token safe?", "check token security", "audit token", or before any swap.
tokr-tokenization-agent
Tokenization agent for the ERC-8004 ecosystem that automates token creation through on-chain feedback and matched token launches.
pay-with-any-token
Pay HTTP 402 payment challenges using tokens via the Tempo CLI and Uniswap Trading API. Use when the user encounters a 402 Payment Required response, needs to fulfill a machine payment, mentions "MPP", "Tempo payment", "pay for API access", "HTTP 402", "x402", "machine payment protocol", "pay-with-any-token", "use tempo", "tempo request", or "tempo wallet".
tokr-tokenization
Tokenization agent for ERC-8004 ecosystem automating token creation through on-chain feedback matching.
token-revoke-mcp
Check and revoke ERC-20 token allowances to secure wallets. Scan for risky unlimited approvals and generate revocation transactions.
rocketpool-tokens
Interact with Rocket Pool token contracts — RPL (governance/staking token) ERC-20 operations, inflation mechanics, old RPL swap, rocketVault balance queries, and L2 token addresses for rETH and RPL on Arbitrum, Optimism, Base, Polygon, zkSync Era, Scroll, Starknet, and Unichain. Supports cast (Foundry CLI) and Ethereum MCP tools on mainnet and Hoodi testnet.
hedera-token-mint
Create and manage tokens on Hedera (HTS). Use for: (1) Minting fungible tokens, (2) Creating NFTs (HTS), (3) Setting up token supplies, (4) Configuring token permissions.
x402-token-sentiment
X/Twitter sentiment analysis API with x402 USDC micropayments on Base at 0.10 USDC per query.
token-unlock-tracker
Query token vesting schedules and upcoming unlock events across the market.
token-unlock-scheduler
Monitor vesting schedules, upcoming unlocks, and token distribution timelines.