スマートアラート

スマートアラートの 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>

オプションリファレンス

フラグ	Create	Update	Toggle	Delete
<id> (positional)		必須	必須	必須
--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 — スマートマネートークンフロー

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://... --webhook https://...
• --webhook <url> はアラートペイロードを含む POST リクエストを任意の HTTP/HTTPS エンドポイントに送信します。サーバーデプロイメント、Zapier、n8n、またはカスタム統合に便利です。エンドポイントは公開アクセス可能で、2xx レスポンスを返す必要があります。
• --data '<json>' は名前付きフラグの上に生の JSON をマージします（名前付きフラグのないフィールドのエスケープハッチ）。
• アラートエンドポイントは内部のみです。内部以外のユーザーは 404 を受け取ります。
• $ または特殊文字を含む名前はシングルクォートを使用してください: --name 'SM >$1M'