nansen-alerts

スマートアラート

スマートアラートの CRUD 管理です。アラートは内部専用です（Nansen 内部 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	任意
--description	任意	任意
--enabled		フラグ	フラグ
--disabled	フラグ	フラグ	フラグ
--data	任意（JSON の代替手段）	任意

アラートの種類

1. sm-token-flows — スマートマネーのトークンフロー

スマートマネー（SM）の流入・流出の合計を追跡します。少なくとも 1 つのフローしきい値を指定する必要があります。

種類固有のフラグ：

• --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 への送金」を追跡するには、--counterparty と send ではなく、--subject と receive を使用します

例：

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://...
• --data '<json>' は、名前付きフラグに加えて生の JSON をマージします（名前付きフラグのないフィールドを指定するための代替手段です）。
• アラートのエンドポイントは内部専用です。内部ユーザー以外には 404 が返されます。
• $ や特殊文字を含む名前には、シングルクォートを使用します：--name 'SM >$1M'