nansen-smart-alerts

身份验证

Nansen 账户 API 调用可以使用选定的 nansen:api 浏览器会话，也可以使用权限相同的常规 API 密钥。NANSEN_API_KEY 优先级最高；可选的 primaryEnv 会保留已配置密钥的注入方式。运行 nansen auth status 可离线选择。仅缓存的访问权限过期时，可在经授权的任务期间自动续期。如果选择匿名、状态无效、续期受阻或存在不确定性，或实际身份验证失败，请停止；绝不要舍弃凭证或回退到匿名 x402 付款。浏览器登录不会授予钱包签名权限、特权服务身份或持久化的 MCP 集成密钥。请保留以下所有确认、签名、制裁和地理区域检查。CLI 2.0.0 中提供浏览器登录，但仅限macOS arm64 预览范围。

智能警报

智能警报的 CRUD 管理。浏览器会话和 API 密钥使用相同的账户和端点检查；登录不会授予特权或内部服务身份。

快速参考

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>

选项参考

标志	创建	更新	切换	删除
<id>（位置参数）		必填	必填	必填
--name	必填	可选
--type	必填	必须搭配类型专用标志
--chains	建议使用	可选
--telegram	聊天 ID	可选
--slack	Webhook URL	可选
--discord	Webhook URL	可选
--webhook	端点 URL	可选	可选
--webhook-secret	可选（仅限 webhook）	可选
--description	可选	可选
--enabled		标志	标志
--disabled	标志	标志	标志
--data	可选（JSON 备用入口）	可选

警报类型

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

跟踪汇总的聪明钱流入／流出。必须至少指定一个流量阈值。

类型专用标志：

• --inflow-1h-min/max、--inflow-1d-min/max、--inflow-7d-min/max（USD 阈值）
• --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>

示例：

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 — 代币转账事件

跟踪符合指定条件的实时转账事件。

主体类型： 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
• 要跟踪“任意地址向 CEX 发送”的情况：对 --subject 使用 receive，而不是对 --counterparty 使用 send

示例：

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 — 智能合约交互

跟踪符合指定条件的合约调用。

特定类型的标志：

• --usd-min/max <usd>
• --signature-hash <hash>（可重复，例如，approve 对应 0x095ea7b3）
• --caller <type:value> / --exclude-caller <type:value>（可重复）
• --contract <type:value> / --exclude-contract <type:value>（可重复）

示例：

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

说明

• 链别名：Hyperliquid = hyperevm，BSC = bnb。
• 可组合多个渠道：--telegram 123 --slack https://... --webhook https://...
• --webhook <url> 会向任意 HTTP/HTTPS 端点发送包含警报载荷的 POST 请求。适用于服务器部署、Zapier、n8n 或自定义集成。该端点必须可从公网访问，并返回 2xx 响应。
• 警报输出会隐藏渠道凭据（Slack/Discord/webhook URL 和 webhook 签名密钥），例如 https://hooks.slack.com/services/T000/****。Webhook URL 可授予向渠道发帖的权限，因此请勿将其放入共享输出；只有在需要完整值时才传入 --reveal。切勿将隐藏后的值传回 --slack/--discord/--webhook；CLI 会拒绝该值。
• --data '<json>' 会将原始 JSON 合并到命名标志之上（用于传递没有对应命名标志的字段）。
• 对所选的两项凭据，警报端点仍会执行常规的所有权、套餐和配额检查。
• 名称包含 $ 或特殊字符时，请使用单引号：--name 'SM >$1M'

浏览器登录使用 nansen:api，其账户 API 权限与 API 密钥相同，但仍受现有套餐、账户和端点检查的约束。交易仍需单独配置钱包并授权其签名。托管式模拟只会在匹配的可信 Nansen API 源站使用所选凭据；任意 RPC 端点都不会收到 Nansen 凭据。