Nansen Smart Alerts

This is a programmatic interface to Nansen's smart alerts system, letting you create and manage token flow monitors, transfer tracking, and contract interaction alerts directly from Claude. You can set up notifications for things like large smart money inflows, specific wallet movements, or contract calls that meet your criteria, all pushed to Telegram, Slack, Discord, or custom webhooks. The skill supports three alert types with extensive filtering: smart money token flows (track aggregated inflows/outflows), common token transfers (monitor specific addresses or entities), and smart contract calls (watch for particular function signatures). Note that this requires a Nansen internal API key, so it's not available for regular Nansen users. The webhook support is nice if you're building custom automation pipelines.

skills.sh installs: 397
GitHub stars: 148
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add nansen-ai/nansen-cli --skill nansen-smart-alerts --agent claude-code

Installs 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.

Smart Alerts

CRUD management for smart alerts. Browser sessions and API keys use the same account and endpoint checks; privileged or internal service identity is not granted by login.