nansen-smart-alerts

認証

Nansen アカウントへの API 呼び出しでは、選択済みの nansen:api ブラウザーセッション、または同じ権限を持つ従来の API キーを使用できます。NANSEN_API_KEY が優先されます。任意の primaryEnv により、設定済みキーの注入を維持できます。オフラインで選択するには、nansen auth status を実行してください。キャッシュされたアクセストークンの有効期限切れのみであれば、許可されたタスクの実行中に自動更新できます。匿名での選択、無効な状態、更新のブロックまたは不確実な状態、実際の認証失敗が発生した場合は停止してください。認証情報を破棄したり、匿名の x402 決済にフォールバックしたりしないでください。ブラウザーログインでは、ウォレット署名、特権サービス ID、永続的な MCP 統合キーは付与されません。以下の確認、署名、制裁対象の確認、地域チェックをすべて維持してください。ブラウザーログインは、macOS arm64 プレビューの対象範囲内で CLI 2.0.0 から利用できます。

スマートアラート

スマートアラートの CRUD 管理です。ブラウザーセッションと API キーには同じアカウントおよびエンドポイントのチェックが適用されます。ログインによって特権サービス ID や内部サービス ID が付与されることはありません。

クイックリファレンス

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 — スマートマネーのトークンフロー

集計された 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 レスポンスを返す必要があります。
• アラートの出力では、チャンネルの認証情報（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 の認証情報が送信されることはありません。