# Research Tokens with Nansen

Token analysts need repeatable commands for deep onchain and market research. This skill guides Claude, Codex, and Claude Code through Nansen CLI workflows for holders, flows, trades, PnL, and perps.

## Install

```bash
npx skillstore add internet-court/nansen-token-research
```

## Metadata

- Status: approved
- Slug: internet-court-nansen-token-research
- Skillstore revision: r1
- Version status: missing
- Tree hash: dfb210957a08a90c938c89302cfc5233b436c7945e01a8f97f87a8c8f8bcc892
- Author: internet-court
- GitHub username: internet-court
- License: MIT
- Repository: https://github.com/internet-court/internet-court-skill/tree/main/vendored/nansen/nansen-token-research
- Ref: 3f6e026a3363e0954ede7bef0cfe88d4475de137
- Supported tools: Claude, Codex, Claude Code
- Audit status: complete
- Agent install advisory: allowed
- Manual install advisory: allowed
- Artifact signature: available
- Audit attestation: unavailable
- Human verification: not\_verified
- Risk factors: external\_commands, env\_access
- Quality score: 77
- Quality tier: bronze
- Public page: https://skillstore.pages.dev/skills/internet-court-nansen-token-research
- Manifest: https://skillstore.pages.dev/api/skills/internet-court-nansen-token-research/manifest

## Capabilities

- Shows commands for token info and OHLCV research by token address and chain.
- Guides holder analysis, including smart-money holder filters when supported.
- Provides commands for token flows, flow intelligence, and bought-sold activity.
- Supports DEX trade, PnL, perpetual trade, position, and leaderboard queries.
- Lists flags for chains, tokens, symbols, timeframes, sorting, fields, tables, and CSV output.

## Use Cases

- Review Token Holder Quality: Use Nansen holder and smart-money commands to compare wallet concentration and tracked holder groups.
- Trace Recent Token Flows: Use flow, flow intelligence, and bought-sold commands to study recent movement across labels and wallets.
- Check Trading and Perp Activity: Use DEX trade, PnL, perp trades, positions, and leaderboard commands before drafting a market brief.

## Prompt Templates

### Basic Token Snapshot

```
Use the nansen-token-research skill to gather token info and 1h OHLCV for <token_address> on solana. Summarize key observations.
```

### Holder and Flow Review

```
Research <token_address> on <chain>. Compare holders, smart-money holders when available, seven-day flows, and flow intelligence labels.
```

### Trading Activity Review

```
Analyze <token_address> on <chain>. Review recent DEX trades and PnL sorted by total PnL. Note unusual trader behavior.
```

### Cross-Market Token Brief

```
Build a token research brief for <token_address> on <chain> and <symbol> perps. Include holders, flows, DEX trades, PnL, perp positions, and risks.
```

## Limitations

- Requires the nansen CLI to be installed and available to the agent.
- Requires NANSEN\_API\_KEY to be configured by the user.
- Only covers Nansen token research commands documented in SKILL.md.
- Results depend on Nansen API availability, chain support, and token liquidity.

## Best Practices

- Confirm the token address, chain, and symbol before running commands.
- Start with token info and OHLCV before deeper holder, flow, or PnL queries.
- Treat illiquid-token and unsupported-filter messages as research caveats.

## Anti Patterns

- Do not paste private API keys into prompts or command arguments.
- Do not assume smart-money filters are available for every token.
- Do not use token symbols for spot endpoints that require token addresses.

## Security Audit

- Audited at: 2026-07-21T03:40:45.364\+00:00
- Summary: All 31 static findings are false positives caused by Markdown code formatting, CLI documentation, and environment-requirement metadata. The skill contains illustrative Nansen CLI queries only; no embedded shell execution, credential handling, reconnaissance, prompt injection, or exfiltration intent was found.

## Stats

- Views: 0
- Downloads: 4
- Favorites: 1
- Popularity score: 0