nansen-limit-orders

認証

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

指値注文

ユーザーが価格をトリガーとする注文を希望する場合は、このスキルを使用してください。明確に異なる 2 つの方法があります。ユーザーのチェーンに合った方法を選んでください。

• Solana → ネイティブ指値注文。 nansen trade limit-order create|list|cancel|update は Nansen 取引 API を通じて実際の未約定注文を出します。Solana 上の注文にはこちらを使用してください。
• その他のチェーン → アラートによる近似。 nansen-cli は EVM チェーンでのネイティブ指値注文にはまだ対応していません。対応する取引所（CEX、指値注文機能を備えた DEX）で未約定注文を出し、決済ウォレットに common-token-transfer スマートアラートを追加して、約定をベストエフォートで通知します。

前提条件

• nansen-cli に設定済みの Solana ウォレット：nansen wallet show <name>（存在しない場合は nansen wallet create）。trade limit-order は、ローカル、Privy、WalletConnect の各ウォレットに対応しています。
• ウォレットには売却トークンと、手数料用の少量の SOL が必要です。
• アラートで代替する場合：通知チャネル（Telegram チャット ID、Slack または Discord の Webhook、または汎用 Webhook URL）。
• スマートアラートには、選択済みの nansen:api ブラウザーセッションまたは従来の API キーが必要です。既存のエンドポイント制限も引き続き適用されます。
• 初回の trade limit-order create では取引用ボールトが自動登録され、JWT が ~/.nansen/limit-order-auth.json に約23時間キャッシュされます。

2つの仕組みであり、1つではありません。 指値注文自体は価格をトリガーとする注文であり、市場価格が目標価格を超えたときに実行されます。追加のスマートアラートは決済確認であり、オンチェーンで取引が決済された後（つまり、購入したトークンが実際にウォレットに届いたとき）に通知されます。それぞれ独立しており、注文がトリガーを処理し、アラートが約定したことをユーザーに通知します。

Solana：ネイティブ指値注文

作成

# --amount is always in token units (e.g. 1 = 1 SOL, 80 = 80 USDC)
nansen trade limit-order create \
  --from SOL --to USDC \
  --amount 1 \
  --trigger-mint SOL --trigger-condition below --trigger-price 80

# with explicit slippage and expiry
nansen trade limit-order create \
  --from SOL --to USDC \
  --amount 1.5 \
  --trigger-mint SOL --trigger-condition above --trigger-price 200 \
  --slippage-bps 300 \
  --expires 7d

必須フラグ：--from、--to、--amount、--trigger-mint、--trigger-condition（above または below）、--trigger-price（USD）。

主なオプション：

• --amount は常にトークン単位（人が読みやすい単位）です。1.5 は 1.5 SOL、80 は 80 USDC を意味します。基本単位モードや金額単位の上書きフラグはありません。そのようなフラグは渡さないでください。
• --slippage-bps <bps> — ベーシスポイント、整数の 0～10000（300 = 3%、100 = 1%）。自動設定する場合は省略します。
• --expires は 24h、7d、30d（デフォルト）、または Unix エポック時刻のミリ秒値を受け付けます。
• デフォルト以外のウォレットを選ぶには、--wallet <name> または --wallet walletconnect（別名 wc）を指定します。

制約（すべてサーバー側で適用されます。エラーはそのままユーザーに提示してください）：

• 注文の最小金額（直近の確認では約 $10）。これを下回ると API が注文を拒否します。
• --from と --to には、有効な Solana ミントアドレスまたは対応するシンボル（SOL、USDC、USDT など）を指定する必要があります。不明なトークンは nansen research search で解決してください。
• 転送フック拡張機能を持つトークン（例：一部の pump.fun トークン）は、作成時に拒否されます。

一覧表示

nansen trade limit-order list                    # default
nansen trade limit-order list --state active     # only open
nansen trade limit-order list --state past       # filled or cancelled
nansen trade limit-order list --mint <mintAddr>  # filter by token
nansen trade limit-order list --limit 50 --offset 0 --dir desc

オプション：--state active|past、--mint <addr>、--limit <n>（デフォルトは 20）、--offset <n>、--sort <field>、--dir asc|desc（デフォルトは desc）、--wallet <name>。

キャンセル

nansen trade limit-order cancel --order <orderId>

キャンセルすると出金トランザクションが送信されます。Solscan でユーザーが確認できるよう、CLI の出力からトランザクション署名を提示してください。

更新

nansen trade limit-order update --order <orderId> --trigger-price 85
nansen trade limit-order update --order <orderId> --slippage-bps 100

更新できるのは --trigger-price と --slippage-bps のみです。サイズやトークンペアを変更するには、キャンセルして作成し直してください。自動スリッページを設定できるのは作成時のみです（create で --slippage-bps を省略します）。update で固定スリッページを自動設定に戻すことはできません。

Solana 以外のチェーン：アラートベースの決済シグナル

現在、nansen-cli は EVM チェーンでネイティブな指値注文を発注できません。代わりに、次の方法が利用できます。

1. 対応する取引所またはプロダクト（CEX、DEX の指値注文プロダクト、アグリゲーター）で指値注文を出します。価格のトリガーは取引所が処理します。
2. 決済ウォレットと同じウォレットを使用します。
3. ウォレット、チェーン、トークン、売買サイドを指定した common-token-transfer スマートアラートを作成します。このアラートは、取引の決済後、つまり購入または売却したトークンが実際にオンチェーンで移動した時点で、約定検知シグナルとして発火します。

2 つの仕組みは次のように連携します。

1. 価格が目標に到達 → 取引所の指値注文が執行されます。 これがトリガーです。nansen-cli は関与しません。
2. トークンがウォレットに到着 → スマートアラートが通知します。 これが決済確認です。アラートは価格トリガーを検知せず、発生した送金のみを検知します。

これはベストエフォートの決済シグナルであり、注文状況を正式に追跡するものではありません。注文状態のポーリング、部分約定の進捗、triggeredAt、fillPercent、残りの注文サイズ、または正規の約定・キャンセル履歴は確認できません。

買い側の決済アラート

nansen alerts create \
  --name 'Settlement signal: buy PEPE on trading wallet' \
  --type common-token-transfer \
  --chains ethereum \
  --events buy \
  --subject address:0xYourWallet \
  --token 0x6982508145454ce325ddbe47a25d4ec3d2311933:ethereum \
  --telegram 5238612255

売り側の決済アラート

nansen alerts create \
  --name 'Settlement signal: sell USDC on trading wallet' \
  --type common-token-transfer \
  --chains base \
  --events sell \
  --subject address:0xYourWallet \
  --token 0x833589fcd6edb6e08f4c7c32d4f71b54bda02913:base \
  --telegram 5238612255

アラートの強化

• 少額の約定を除外するには、--usd-min <amount> を指定します。
• 意図をアラートに記録するには、--description '<limit price / venue / notes>' を指定します。
• トークンのフィルターを設定せず、ウォレット全体を対象にした送金アラートは推奨しないでください。過剰に発火します。
• アラート通知を「注文が約定した」または「トリガーされた」と表現しないでください。アラートが示すのは、ウォレット上で一致するトークン送金が観測されたという証拠にすぎず、正確な約定検知ではありません。
• 取引所の決済方法が、アラートバックエンドによって buy／sell ではなく一般的な送金として分類される場合、対象を絞ったアラートでは検知できないことがあります。ユーザーが、より広いマッチングと無関係な送金にも一致するリスクを許容する場合に限り、--events buy,receive または --events sell,send に範囲を広げてください。

任意：Solana での念には念を入れた対応

Solana のネイティブ指値注文では、決済ウォレットに対する common-token-transfer アラートを併用すると便利ですが、必須ではありません。これは決済確認であり、価格トリガーではありません。 価格トリガーは指値注文自体が処理します。アラートは、購入したトークンが実際にウォレットに到着したとき（売却の場合は、売却したトークンがウォレットから出たとき）に発火します。これにより、オンチェーンで約定が反映されたことを証明し、trade limit-order list によるポーリングとは独立して Telegram／webhook 経由で通知します。

一部の取引所では、アラートバックエンドが buy／sell として分類できないプログラム経由で約定を処理するため、これもベストエフォートの決済シグナルにすぎず、正式な約定検知ではありません。上記と同じ形式の common-token-transfer アラートを併用してください。

ユーザーへの説明

アラートの併用を提案する場合、異なる 2 つの仕組みが働いていることを明確に伝えてください。ユーザーはこの 2 つを混同しがちです。

• 指値注文は価格トリガーです。市場価格が目標を超えると執行されます。
• スマートアラートは決済確認です。取引がオンチェーンで決済された後に通知します。

推奨する表現：「注文が約定してトークンがウォレットに到着すると、Telegram で通知が届きます。価格トリガーは指値注文自体が処理し、アラートは約定が反映されたことを確認するだけです。」

アラートが注文を「トリガーする」、またはアラート自体が価格を監視するような表現は避けてください。どちらも行いません。

注意事項

• アラートのチェーンエイリアス：Hyperliquid = hyperevm、BSC = bnb。
• $ または特殊文字を含む名前には、シングルクォートを使用してください。
• 即時スワップ（価格トリガーではないもの）には、nansen-trading スキルを使用してください。
• アラートを Webhook で配信する場合は、nansen-alerts-webhook-listener と組み合わせてください。

ソース

• npm：https://www.npmjs.com/package/nansen-cli
• GitHub：https://github.com/nansen-ai/nansen-cli