mcpField
N
nansen-alerts

nansen-alerts

github.com/nansen-aiOther14438 installsUpdated today
Repository

About nansen-alerts

nansen-alerts is a command-line skill for creating and managing Nansen smart alerts. It supports several blockchain event types, configurable filters, and notification destinations; its alert endpoints require an internal Nansen API key.

Key features

  1. 01Create, update, toggle, and delete alerts
  2. 02Track smart-money token flows
  3. 03Filter token transfer events
  4. 04Monitor smart contract calls
  5. 05Send alerts to Telegram, Slack, or Discord

Use cases

  1. 01Track token inflows and outflows above thresholds
  2. 02Watch transfers by address, entity, or label
  3. 03Monitor selected contract calls
  4. 04Route alert notifications to configured channels

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/nansen-ai/nansen-cli --skill nansen-alerts

After installing, type/nansen-alertsin Claude Code to confirm it loaded.

Details

From the project README

Smart Alerts

CRUD management for smart alerts. Alerts are internal-only (requires Nansen internal API key).

Quick Reference

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
--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:

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:

nansen alerts create \
  --name 'Large USDC Transfers' \
  --type common-token-transfer \
  --chains ethereum \
  --telegram 123456789 \
  --events send,receive \
  --usd-min 1000000 \
  --token 0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48:ethereum
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:

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://...
  • --data '<json>' merges raw JSON on top of named flags (escape hatch for fields without named flags).
  • Alert endpoints are internal-only. Non-internal users receive 404.
  • Use single quotes for names with $ or special characters: --name 'SM >$1M'

Comments

Markdown supported