
Nansen Agent Guide
This is a routing guide that helps Claude decide whether to use Nansen's AI agent or direct CLI commands for blockchain research queries. The core logic is simple: use the agent (200-750 credits) for analysis and interpretation like "what's happening with smart money," and use direct CLI commands (5-50 credits) for raw data like token screeners or wallet balances. The anti-patterns section is the most useful part, especially the reminder that chaining multiple agent calls is wasteful. If you're building anything that touches Nansen's API, this saves you from burning credits on the wrong tool for the job.
- skills.sh installs
- 240
- GitHub stars
- 148
- last updated
- Aug 21, 2026
Install
$ npx -y skills add nansen-ai/nansen-cli --skill nansen-agent-guide --agent claude-codeInstalls into .claude/skills of the current project.
Files
Authentication
Nansen account API calls accept a selected nansen:api browser session or conventional API key with the same permissions. NANSEN_API_KEY takes precedence; optional primaryEnv preserves configured-key injection. Run nansen auth status for offline selection. Cached access expiry alone permits automatic renewal during an authorized task. Stop on anonymous selection, invalid state, blocked/uncertain renewal or actual auth failure; never drop a credential or fall back to anonymous x402 payment. Browser login does not grant wallet signing, privileged service identity or a persistent MCP integration key. Preserve all confirmation, signing, sanctions and geographic checks below. Browser login is enabled in production within the documented platform scope.
Agent vs CLI Routing
Public agent fast/expert and direct API commands accept the selected nansen:api browser session or conventional API key under the same account permissions.
Sponsors
Details
- Repository
- github.com/nansen-ai/nansen-cli
- Categories
- Documentation, AI & Agent Building, Data Science & ML, CLI & Terminal
- First seen
- Jun 3, 2026
More from nansen-ai/nansen-cli
All 37- Nansen Smart Money165
- Nansen Search138
- Nansen Token136
- Nansen Profiler133
- Nansen Wallet124
- Nansen Trade122
- Nansen Web Searcher659
- Nansen Smart Money Tracker551
- Nansen Prediction Markets495
- Nansen Smart Money Alpha479
- Nansen Web Fetcher463
- Nansen Portfolio Tracker449
- Nansen Token Research441
- Nansen Trading436
- Nansen Fund Tracker431
- Nansen Smart Money Trend428
- Nansen Wallet Profiler413
- Nansen General Search412
- Nansen Defi Positions410
- Nansen Token Screener408
- Nansen Polymarket Deep Dive401
- Nansen Holder Analysis398
- Nansen Smart Alerts397
- Nansen Polymarket Trader Profile395