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

选项参考

Flag	Create	Update	Toggle	Delete
`<id>` (positional)		required	required	required
`--name`	required	optional
`--type`	required	required with type-specific flags
`--chains`	recommended	optional
`--telegram`	chat ID	optional
`--slack`	webhook URL	optional
`--discord`	webhook URL	optional
`--description`	optional	optional
`--enabled`		flag	flag
`--disabled`	flag	flag	flag
`--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

警报类型

sm-token-flows

— Smart Money Token Flows

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

common-token-transfer

— Token Transfer Events

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

smart-contract-call

— Smart Contract Interactions

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'
```

nansen-alerts

Original

Translation

Smart Alerts

智能警报

Quick Reference

快速参考

Options Reference

选项参考

Alert Types

警报类型

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

1.
`sm-token-flows`
— 聪明钱代币流向

2.
`common-token-transfer`
— Token Transfer Events

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

3.
`smart-contract-call`
— Smart Contract Interactions

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

Notes

注意事项

nansen-alerts

Original

Translation

Smart Alerts

智能警报

Quick Reference

快速参考

Options Reference

选项参考

Alert Types

警报类型

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

1. sm-token-flows — 聪明钱代币流向

2. common-token-transfer — Token Transfer Events

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

3. smart-contract-call — Smart Contract Interactions

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

Notes

注意事项

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

1.
`sm-token-flows`
— 聪明钱代币流向

2.
`common-token-transfer`
— Token Transfer Events

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

3.
`smart-contract-call`
— Smart Contract Interactions

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