用途:通过 nansen alerts 子命令对智能告警做增删改查,用于配置代币资金流、聪明钱、代币转账、智能合约调用等通知规则。
认证:Nansen 账户 API 调用接受已选中的 nansen:api 浏览器会话或常规 API 密钥,二者权限相同。NANSEN_API_KEY 优先;可用 nansen auth status 查看离线选择。匿名、状态无效、续期受阻或认证失败时应停止,不得丢弃凭据或回退到匿名 x402 支付。浏览器登录不授予钱包签名、特权服务身份或持久 MCP 集成密钥。浏览器登录在 CLI 2.0.0 的 macOS arm64 预览范围内可用。
主要命令: 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>
通用选项:创建需 --name 与 --type;--chains 推荐;通知渠道可组合 --telegram、--slack、--discord、--webhook,webhook 可配 --webhook-secret;--description 可选;更新支持 --data '<json>' 作为无命名标志字段的补充。名称含 $ 或特殊字符时用单引号。链别名:Hyperliquid=hyperevm,BSC=bnb。
告警类型:1) sm-token-flows——跟踪聪明钱代币流入/流出,至少指定一个流量阈值,可用 --inflow/--outflow/--netflow 的 1h/1d/7d min/max、--token、--exclude-token、--token-sector、--token-age-max、--market-cap、--fdv 等。2) common-token-transfer——跟踪实时转账事件,subject 类型有 address、entity、label、custom-label,格式 --subject type:value;配 --events(buy,sell,swap,send,receive)、--usd、--token-amount、--counterparty、--token、--token-sector、--exclude-from/--exclude-to 等。方向说明:对 counterparty 的 buy 等于对 subject 的 sell,send 等于 receive;跟踪“任意地址转入 CEX”应用 --subject 配 receive。3) smart-contract-call——跟踪合约调用,可用 --usd、--signature-hash、--caller、--contract 等。
限制:告警端点对所选凭据仍保留常规的归属、套餐与配额检查;交易仍需单独配置钱包及签名授权;托管模拟仅在匹配的受信任 Nansen API 源使用所选凭据,任意 RPC 端点不会收到 Nansen 凭据。webhook 端点须公网可达并返回 2xx。