New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Nansen Smart Alerts

by nansen-ai in nansen-ai/nansen-cli

Manage smart alerts — list, create, update, toggle, delete. An agent skill from nansen-ai/nansen-cli.

MITAuto-check passedBackend & APIs

Install Nansen Smart Alerts

skills CLI
$ npx skills add nansen-ai/nansen-cli --skill nansen-smart-alerts -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install nansen-ai/nansen-cli nansen-smart-alerts --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/nansen-ai/nansen-cli.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/nansen-smart-alerts .claude/skills/nansen-smart-alerts && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
nansen-smart-alerts
GitHub stars
139
Token cost
~1.6k tokens
SKILL.md length
527 words
Files
1
Skills in repo
32
Repo updated
First seen
Licence
MIT

At a glance

Manage smart alerts — list, create, update, toggle, delete. An agent skill from nansen-ai/nansen-cli.

  • Works in 3 steps: sm-token-flows — Smart Money Token Flows → common-token-transfer — Token Transfer… → smart-contract-call — Smart Contract…
  • Managing token flow alerts
  • SKILL.md covers Authentication, Quick Reference, Options Reference and Alert Types, plus 1 more section
  • Needs NANSEN_API_KEY

What it does

Nansen Smart Alerts is an agent skill from nansen-ai/nansen-cli. Manage smart alerts — list, create, update, toggle, delete. Use when setting up or managing token flow alerts, smart money alerts, or notification rules.

Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Backend & APIs. The licence is MIT.

When your agent uses it

  • Managing token flow alerts
  • Smart money alerts
  • Notification rules

Example prompts

  • “/nansen-smart-alerts”

Requirements

  • A credential in NANSEN_API_KEY
  • Pre-approved tools (allowed-tools): Bash(nansen:*)

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. sm-token-flows — Smart Money Token Flows
  2. common-token-transfer — Token Transfer Events
  3. smart-contract-call — Smart Contract Interactions

What it can do on your machine

Read from SKILL.md and the folder at commit d097942. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash(nansen:*)

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • NANSEN_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Nansen Smart Alerts loads about 1.6k tokens when it runs. Until then it costs about 43 tokens; SKILL.md has 527 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~43
When it runs · the whole SKILL.md, loaded when a task matches
~1.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from nansen-ai/nansen-cli at commit d097942, republished under its MIT licence (© nansen-ai). 527 words, ~1,609 tokens.

Download SKILL.mdSave it as .claude/skills/nansen-smart-alerts/SKILL.md (or your agent's skills folder).
name
nansen-smart-alerts
description
Manage smart alerts — list, create, update, toggle, delete. Use when setting up or managing token flow alerts, smart money alerts, or notification rules.
allowed-tools
Bash(nansen:*)

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 available in CLI 2.0.0 within the macOS arm64 preview 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.

Quick Reference

bash
nansen alerts list --table
nansen alerts create --name <name> --type <type> --chains <chains> --telegram <chatId>
nansen alerts update <id> [--name <name>] [--chains <chains>]
nansen alerts toggle <id> --enabled|--disabled
nansen alerts delete <id>

Options Reference

FlagCreateUpdateToggleDelete
<id> (positional)requiredrequiredrequired
--namerequiredoptional
--typerequiredrequired with type-specific flags
--chainsrecommendedoptional
--telegramchat IDoptional
--slackwebhook URLoptional
--discordwebhook URLoptional
--webhookendpoint URLoptionaloptional
--webhook-secretoptional (webhook only)optional
--descriptionoptionaloptional
--enabledflagflag
--disabledflagflagflag
--dataoptional (JSON escape hatch)optional

Alert Types

1. sm-token-flows — Smart Money Token Flows

Track aggregated SM inflow/outflow. At least one flow threshold should be specified.

Type-specific flags:

  • --inflow-1h-min/max, --inflow-1d-min/max, --inflow-7d-min/max (USD thresholds)
  • --outflow-1h-min/max, --outflow-1d-min/max, --outflow-7d-min/max
  • --netflow-1h-min/max, --netflow-1d-min/max, --netflow-7d-min/max
  • --token <address:chain> (repeatable) — include specific tokens
  • --exclude-token <address:chain> (repeatable)
  • --token-sector <name> / --exclude-token-sector <name> (repeatable)
  • --token-age-max <days>
  • --market-cap-min/max <usd>, --fdv-min/max <usd>

Example:

bash
nansen alerts create \
  --name 'SM ETH Inflow >5M' \
  --type sm-token-flows \
  --chains ethereum \
  --telegram 5238612255 \
  --inflow-1h-min 5000000 \
  --token 0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2:ethereum
2. common-token-transfer — Token Transfer Events

Track real-time transfer events matching specified criteria.

Subject types: address, entity, label, custom-label Format: --subject type:value (e.g. --subject label:"Centralized Exchange")

Type-specific flags:

  • --events <buy,sell,swap,send,receive> (comma-separated)
  • --usd-min/max <usd>, --token-amount-min/max <n>
  • --subject <type:value> (repeatable) — addresses/entities/labels to track
  • --counterparty <type:value> (repeatable) — requires --subject
  • --token <address:chain> / --exclude-token <address:chain> (repeatable)
  • --token-sector <name> / --exclude-token-sector <name> (repeatable)
  • --token-age-min/max <days>, --market-cap-min/max <usd>
  • --exclude-from <type:value> / --exclude-to <type:value> (repeatable)

Event direction notes:

  • buy for counterparties = sell for subjects
  • send for counterparties = receive for subjects
  • To track "any address sending to CEX": use --subject with receive, not --counterparty with send

Example:

bash
nansen alerts create \
  --name 'Large USDC Transfers' \
  --type common-token-transfer \
  --chains ethereum \
  --telegram 123456789 \
  --events send,receive \
  --usd-min 1000000 \
  --token 0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48:ethereum
Show full SKILL.md (179 more words)Show less
3. smart-contract-call — Smart Contract Interactions

Track contract calls matching specified criteria.

Type-specific flags:

  • --usd-min/max <usd>
  • --signature-hash <hash> (repeatable, e.g. 0x095ea7b3 for approve)
  • --caller <type:value> / --exclude-caller <type:value> (repeatable)
  • --contract <type:value> / --exclude-contract <type:value> (repeatable)

Example:

bash
nansen alerts create \
  --name 'Uniswap V3 Large Swaps' \
  --type smart-contract-call \
  --chains ethereum \
  --telegram 123456789 \
  --usd-min 1000000 \
  --contract entity:"Uniswap V3"

Notes

  • Chain aliases: Hyperliquid = hyperevm, BSC = bnb.
  • Multiple channels can be combined: --telegram 123 --slack https://... --webhook https://...
  • --webhook <url> sends a POST request with the alert payload to any HTTP/HTTPS endpoint. Useful for server deployments, Zapier, n8n, or custom integrations. The endpoint must be publicly reachable and return a 2xx response.
  • --data '<json>' merges raw JSON on top of named flags (escape hatch for fields without named flags).
  • Alert endpoints retain their normal ownership, plan and quota checks for both selected credentials.
  • Use single quotes for names with $ or special characters: --name 'SM >$1M'

Browser login uses nansen:api with the same account API permissions as an API key, subject to existing plan/account/endpoint checks. Trading still requires a separately configured wallet and its signing authorization. Hosted simulation uses the selected credential only on the matching trusted Nansen API origin; arbitrary RPC endpoints never receive Nansen credentials.

© nansen-ai, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/nansen-smart-alerts of nansen-ai/nansen-cli.

Open the folder on GitHubat commit d097942

Compare with similar skills

Nansen Smart Alerts next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Nansen Smart Alerts compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Nansen Smart Alerts this skillnansen-ai/nansen-cli139—~1.6kAutomated safety check: PassMIT
Configuring Horizoncoollabsio/coolify63k4 repos~898Automated safety check: PassMIT
Nestjs Best Practicesrolling-scopes/rsschool-app10k6 repos~1.2kAutomated safety check: PassMIT
Sub2API AdminWei-Shaw/sub2api44k1 repos~717Automated safety check: PassLGPL-3.0
Firecrawl Build Onboardingfirecrawl/firecrawl190k1 repos~1.4kAutomated safety check: NotesISC
Obsidian BasesAtmosphere/atmosphere3.8k22 repos~3.2kAutomated safety check: PassApache-2.0

Similar skills

  • Configuring Horizon

    coollabsio/coolify

    A skill your agent uses whenever the user mentions Horizon by name in a Laravel context.

    63k GitHub starsUsed in 4 repos~898 tokens
    Backend & APIsAuto-check passed

  • Nestjs Best Practices

    rolling-scopes/rsschool-app

    NestJS best practices and architecture patterns for building production-ready applications.

    10k GitHub starsUsed in 6 repos~1.2k tokens
    Backend & APIsAuto-check passed

  • Sub2API Admin

    Wei-Shaw/sub2api

    Manages a Sub2API deployment from the command line: accounts, redeem and invitation codes, groups, proxies, imports, exports and raw admin API calls.

    44k GitHub starsUsed in 1 repo~717 tokens
    Backend & APIsAuto-check passed

  • Firecrawl Build Onboarding

    firecrawl/firecrawl

    Gets Firecrawl working in a project: signs you in through the browser, saves FIRECRAWL_API_KEY to .env and picks the first SDK or REST path.

    190k GitHub starsUsed in 1 repo~1.4k tokens
    Backend & APIsAuto-check: notes

  • Obsidian Bases

    Atmosphere/atmosphere

    Create and edit Obsidian Bases (.base files) with views, filters, formulas, and summaries.

    3.8k GitHub starsUsed in 22 repos~3.2k tokens
    Backend & APIsAuto-check passed

  • Fortify Development

    coollabsio/coolify

    ACTIVATE when the user works on authentication in Laravel. An agent skill from coollabsio/coolify.

    63k GitHub starsUsed in 4 repos~1.9k tokens
    Backend & APIsAuto-check passed

More from nansen-ai/nansen-cli

All 32 skills in this repo

  • Nansen Smart Money Tracker

    nansen-ai/nansen-cli

    Smart money tracking — netflow, trades, holdings, perp trades.

    139 GitHub starsUsed in 2 repos~1.1k tokens
    Auto-check passed

  • Nansen Token Research

    nansen-ai/nansen-cli

    Token deep dive — info, OHLCV, holders, flows, flow intelligence, who bought/sold, DEX trades, PnL, perp trades, perp positions, perp PnL leaderboard.

    139 GitHub starsUsed in 2 repos~1.2k tokens
    Auto-check passed

  • Nansen Wallet Profiler

    nansen-ai/nansen-cli

    Wallet profiler — balance, PnL, labels, transactions, counterparties, related wallets, batch, trace, compare.

    139 GitHub starsUsed in 2 repos~1.5k tokens
    Auto-check passed

  • Nansen Agent Guide

    nansen-ai/nansen-cli

    Routing guide -- when to use nansen agent (AI research) vs direct CLI data commands.

    139 GitHub stars~948 tokensUpdated 2 days ago
    Auto-check passed

  • Nansen Limit Orders

    nansen-ai/nansen-cli

    Guide users through native limit orders on Solana via nansen trade limit-order create|list|cancel|update, and the alert-based settlement-signal fallback for chains without native support.

    139 GitHub stars~2.5k tokensUpdated 2 days ago
    Auto-check passed

  • Nansen General Search

    nansen-ai/nansen-cli

    Search for tokens or entities by name. An agent skill from nansen-ai/nansen-cli.

    139 GitHub starsUsed in 2 repos~776 tokens
    Auto-check passed

Categories

Questions about Nansen Smart Alerts

What does Nansen Smart Alerts do?

Manage smart alerts — list, create, update, toggle, delete. An agent skill from nansen-ai/nansen-cli. Nansen Smart Alerts is an agent skill from nansen-ai/nansen-cli. Manage smart alerts — list, create, update, toggle, delete.

When should I use Nansen Smart Alerts?

Nansen Smart Alerts fits situations like: managing token flow alerts; smart money alerts; notification rules.

How do I install Nansen Smart Alerts in Claude Code?

Run `npx skills add nansen-ai/nansen-cli --skill nansen-smart-alerts -a claude-code`. Or copy the skill folder (skills/nansen-smart-alerts in nansen-ai/nansen-cli) into .claude/skills/nansen-smart-alerts in your project. Claude Code loads it when a task matches its description.

How do I install Nansen Smart Alerts in Codex?

Run `npx skills add nansen-ai/nansen-cli --skill nansen-smart-alerts -a codex`. Or copy the skill folder (skills/nansen-smart-alerts in nansen-ai/nansen-cli) into .agents/skills/nansen-smart-alerts in your project. Codex loads it when a task matches its description.

Can I use Nansen Smart Alerts in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add nansen-ai/nansen-cli --skill nansen-smart-alerts -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/nansen-smart-alerts, .gemini/skills/nansen-smart-alerts, .github/skills/nansen-smart-alerts and .opencode/skills/nansen-smart-alerts in your project.

What does Nansen Smart Alerts need to run?

Going by SKILL.md and its folder, Nansen Smart Alerts needs credentials named NANSEN_API_KEY. Our summary lists: A credential in NANSEN_API_KEY. Its frontmatter pre-approves these tools: Bash(nansen:*).

Does Nansen Smart Alerts access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Nansen Smart Alerts safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Nansen Smart Alerts use?

Nansen Smart Alerts is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Nansen Smart Alerts use?

About 1.6k tokens (SKILL.md is roughly 6.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Nansen Smart Alerts?

Skills that share tags, products or a category with Nansen Smart Alerts: Configuring Horizon (coollabsio/coolify, 63k stars), Nestjs Best Practices (rolling-scopes/rsschool-app, 10k stars), Sub2API Admin (Wei-Shaw/sub2api, 44k stars) and Firecrawl Build Onboarding (firecrawl/firecrawl, 190k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Nansen Smart Alerts?

nansen-ai (a GitHub organization) maintains it in nansen-ai/nansen-cli, which has 139 GitHub stars. The repository holds 32 skills in this directory. The repository was last updated on October 9, 2026.

Source: nansen-ai/nansen-cli on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.