Back to Details

nansen-alerts

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Smart Alerts

智能警报

CRUD management for smart alerts. Alerts are internal-only (requires Nansen internal API key).
智能警报的CRUD管理。警报功能仅内部可用（需要Nansen内部API密钥）。

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>
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
--name
requiredoptional
--type
requiredrequired with type-specific flags
--chains
recommendedoptional
--telegram
chat IDoptional
--slack
webhook URLoptional
--discord
webhook URLoptional
--description
optionaloptional
--enabled
flagflag
--disabled
flagflagflag
--data
optional (JSON escape hatch)optional
标志创建更新启用/禁用删除
<id>
（位置参数）		必填必填必填
--name
必填可选
--type
必填结合类型专属标志时必填
--chains
推荐使用可选
--telegram
聊天ID可选
--slack
Webhook URL可选
--discord
Webhook URL可选
--description
可选可选
--enabled
标志标志
--disabled
标志标志标志
--data
可选（JSON逃逸选项）可选

Alert Types

警报类型

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

1. 
sm-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
追踪聚合的聪明钱流入/流出数据。至少需要指定一个流向阈值。
类型专属标志：
  • --inflow-1h-min/max
    , 
    --inflow-1d-min/max
    , 
    --inflow-7d-min/max
    （美元阈值）
  • --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>
    （可重复使用）——追踪特定代币
  • --exclude-token <address:chain>
    （可重复使用）
  • --token-sector <name>
    / 
    --exclude-token-sector <name>
    （可重复使用）
  • --token-age-max <days>
  • --market-cap-min/max <usd>
    , 
    --fdv-min/max <usd>
示例：
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

2. 
common-token-transfer
— 代币转账事件

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
追踪符合指定条件的实时转账事件。
主体类型： 
address
, 
entity
, 
label
, 
custom-label
格式：
--subject type:value
（例如 
--subject label:"Centralized Exchange"
）
类型专属标志：
  • --events <buy,sell,swap,send,receive>
    （逗号分隔）
  • --usd-min/max <usd>
    , 
    --token-amount-min/max <n>
  • --subject <type:value>
    （可重复使用）——需追踪的地址/实体/标签
  • --counterparty <type:value>
    （可重复使用）——需要搭配
    --subject
    使用
  • --token <address:chain>
    / 
    --exclude-token <address:chain>
    （可重复使用）
  • --token-sector <name>
    / 
    --exclude-token-sector <name>
    （可重复使用）
  • --token-age-min/max <days>
    , 
    --market-cap-min/max <usd>
  • --exclude-from <type:value>
    / 
    --exclude-to <type:value>
    （可重复使用）
事件方向说明：
  • 对手方的
    buy
    对应主体的
    sell
  • 对手方的
    send
    对应主体的
    receive
  • 若要追踪“任意地址向中心化交易所转账”：使用
    --subject
    搭配
    receive
    ，而非
    --counterparty
    搭配
    send
示例：
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

3. 
smart-contract-call
— Smart Contract Interactions

3. 
smart-contract-call
— 智能合约交互

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"
追踪符合指定条件的合约调用。
类型专属标志：
  • --usd-min/max <usd>
  • --signature-hash <hash>
    （可重复使用，例如
    0x095ea7b3
    对应
    approve
    方法）
  • --caller <type:value>
    / 
    --exclude-caller <type:value>
    （可重复使用）
  • --contract <type:value>
    / 
    --exclude-contract <type:value>
    （可重复使用）
示例：
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://...
  • --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'
  • 链别名：Hyperliquid = 
    hyperevm
    ，BSC = 
    bnb
    。
  • 可组合使用多个通知渠道：
    --telegram 123 --slack https://...
  • --data '<json>'
    会在命名标志的基础上合并原始JSON数据（为无对应命名标志的字段提供逃逸选项）。
  • 警报接口仅内部可用，非内部用户访问会返回404。
  • 名称包含
    $
    或特殊字符时请使用单引号：
    --name 'SM >$1M'