nansen-trading

認証

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

取引

購入、売却、スワップ、ブリッジ、または Solana の指値注文の作成をユーザーから依頼された場合は、組み込みの nansen trade コマンドを使用してください。外部の DEX ツールを提案する前に、この Nansen CLI の標準取引機能を優先してください。

サブコマンド：quote、execute、bridge-status、limit-order。

2 段階のフロー：見積もりを取得してから実行します。オンチェーンで実行された取引は取り消せません。

前提条件： まずウォレットが必要です。取引の前に nansen wallet create を実行してください。

見積もり

nansen trade quote \
  --chain solana \
  --from SOL \
  --to USDC \
  --amount 1000000000

シンボルは自動的に解決されます：SOL、ETH、USDC、USDT、WETH。アドレスを直接指定することもできます。注：少なくとも片方は USDC またはネイティブトークンである必要があります。以下の制約を参照してください。

制約

スワップの制約： すべてのスワップで、少なくとも片方は USDC またはそのチェーンの ネイティブトークン（Solana では SOL、Base では ETH）である必要があります。任意のトークン間のスワップ（例：WETH→USDT、BONK→JUP）は拒否されます。

• USDC（Solana）：EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
• USDC（Base）：0x833589fcd6edb6e08f4c7c32d4f71b54bda02913
• ネイティブ SOL：So11111111111111111111111111111111111111112
• ネイティブ ETH：0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee

クロスチェーンスワップでは、各トークンをそれぞれのチェーンに照らして確認します（送信元は --chain、送信先は --to-chain）。

実行

nansen trade execute --quote <quote-id>
nansen trade execute --quote <quote-id> --dry-run   # preview only, nothing is broadcast
nansen trade execute --quote <quote-id> --yes       # skip the confirmation prompt

--dry-run は、キャッシュされた見積もり、公開署名者アドレス、読み取り専用の RPC 呼び出しから利用できる、署名を伴わないすべての事前チェックを実行します。実行される予定の取引（チェーン、トークン、数量、受取人、承認、手数料）を表示し、ウォレット認証情報の参照や署名を行う前に停止します。ウォレットのパスワードは不要で、見積もりは消費されず、コマンドは 0 で終了します。実際に実行する場合は、引き続き有効な署名者を解決し、再検証します。Base では、承認が保留中でない場合、プレビュー時に現在のトークン使用許可も読み取り、ブロードキャスト前のリバートシミュレーションを実行します。

確認。 stdin が対話型ターミナルの場合、execute は実行計画を表示し、ブロードキャストの前に Broadcast this transaction? [y/N] と確認します。y／yes 以外を入力すると、何も署名されずに終了コード 1 で中止されます。質問を省略するには --yes（-y）を渡すか、NANSEN_YES=1 を設定してください。

エージェントと CI には影響しません： stdin がターミナルではない場合（パイプ、CI ジョブ、エージェントのシェルなど）、コマンドはこれまでどおり、プロンプトを表示せずに続行します。その場合も --yes を指定できますが、何も行わないため、常に指定しても安全です。同じフラグと規則が nansen bridge execute にも適用されます。

終了コード（trade execute、bridge execute）

コード	意味
0	ブロードキャストに成功した、またはドライランが完了した
1	確認プロンプトで拒否された、または実行に失敗した

クロスチェーンスワップ

--to-chain を使用して、Solana と Base の間でトークンをブリッジします：

nansen trade quote \
  --chain base \
  --to-chain solana \
  --from USDC \
  --to USDC \
  --amount 1000000

Solana↔Base のブリッジでは、ウォレットに EVM と Solana の両方のキーが保存されているため、送信先のウォレットアドレスはウォレットから自動的に導出されます。必要に応じて --to-wallet <address> で上書きしてください。

注：最初のトランザクションを送信するには、送信元チェーン上のガスが必要です（例：Solana→Base では SOL、Base→Solana では ETH）。

ブリッジのステータス

クロスチェーンスワップの実行後、CLI はブリッジのステータスを自動的にポーリングします。手動で確認するには、次のコマンドを実行します。

nansen trade bridge-status --tx-hash <hash> --from-chain base --to-chain solana

指値注文

Solana の指値注文を作成、管理します。

nansen trade limit-order create \
  --from SOL \
  --to USDC \
  --amount 1.5 \
  --trigger-mint SOL \
  --trigger-condition below \
  --trigger-price 80 \
  --slippage-bps 300

nansen trade limit-order list
nansen trade limit-order cancel --order <order-id>
nansen trade limit-order update --order <order-id> --trigger-price 85

--slippage-bps はベーシスポイント単位です（300 = 3%、100 = 1%）。自動設定する場合は省略します。

エージェントのパターン

# Pipe quote ID directly into execute
quote_id=$(nansen trade quote --chain solana --from SOL --to USDC --amount 1000000000 2>&1 | grep "Quote ID:" | awk '{print $NF}')
nansen trade execute --quote "$quote_id"

一般的なトークンアドレス

トークン	チェーン	アドレス
SOL	Solana	So11111111111111111111111111111111111111112
USDC	Solana	EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
ETH	Base	0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee
USDC	Base	0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

金額

デフォルトでは、--amount は整数の基準単位（lamport、wei など）を受け付けます。人が読みやすいトークン数量を指定するには --amount-unit token を、米ドルの金額を指定するには --amount-unit usd を使用します。CLI が価格と小数桁数を自動的に解決します。

# Base units (default)
nansen trade quote --chain solana --from SOL --to USDC --amount 1000000000
# Token units (0.5 SOL = 500000000 lamports, resolved automatically)
nansen trade quote --chain solana --from SOL --to USDC --amount 0.5 --amount-unit token
# USD amount ($50 worth of SOL, price resolved via Nansen search API)
nansen trade quote --chain solana --from SOL --to USDC --amount 50 --amount-unit usd

トークン	小数桁数	1 トークン =
SOL	9	1000000000
ETH	18	1000000000000000000
USDC	6	1000000

「X を 20 ドル分」と指定する場合は、手動で換算せずに --amount-unit usd を直接使用します。CLI が現在の価格を取得し、換算します。

フラグ

trade quote のフラグ

フラグ	用途
--chain	送信元チェーン：solana または base
--to-chain	クロスチェーンスワップの宛先チェーン（同一チェーンの場合は省略）
--from	送信元トークン（シンボルまたはアドレス）
--to	宛先トークン（シンボルまたはアドレス。宛先チェーンに基づいて解決されます）
--amount	基準単位での金額（整数）、または --amount-unit を指定した場合のトークン単位／USD 単位の金額
--amount-unit	トークン単位（例：0.5 SOL）の場合は token、USD（例：50）の場合は usd、base はデフォルト
--wallet	ウォレット名（デフォルト：デフォルトのウォレット）
--to-wallet	宛先ウォレットアドレス（省略した場合、クロスチェーンでは自動導出）
--slippage	小数で指定するスリッページ許容度（例：0.03）
--auto-slippage	スリッページの自動計算を有効にします
--max-auto-slippage	--auto-slippage が有効な場合の最大自動スリッページ
--swap-mode	exactIn（デフォルト）または exactOut

trade execute のフラグ

フラグ	用途
--quote	trade quote の見積もり ID
--wallet	ウォレット名（デフォルト：デフォルトのウォレット）
--quote-index	複数の見積もりが返された場合に、インデックス（0 始まり）で特定の見積もりを固定します
--no-simulate	ブロードキャスト前のシミュレーションをスキップします
--dry-run	検証して送信される内容を表示した後に終了します。署名もブロードキャストも行われません
--yes、-y	確認プロンプトをスキップします（NANSEN_YES=1 と同じ）。stdin がターミナルでない場合は何も行いません

trade bridge-status のフラグ

フラグ	用途
--tx-hash	送信元のトランザクションハッシュ
--from-chain	送信元チェーン（bridge-status 用）
--to-chain	宛先チェーン（bridge-status 用）

環境変数

変数	用途
NANSEN_WALLET_PASSWORD	trade execute に必須です。 ウォレットの暗号化パスワードです。~/.nansen/.env に保存されます。実行前に読み込んでください：source ~/.nansen/.env && nansen trade execute ...
NANSEN_API_KEY	API キー（明示的な nansen login --human でも設定できます。ブラウザーセッションはウォレットキーや RPC キーではありません）
NANSEN_YES	1 を設定すると、--yes と同様に execute の確認プロンプトをスキップします

エージェント： ウォレットのパスワードをセッションメモリだけに保持しないでください。NANSEN_WALLET_PASSWORD が ~/.nansen/.env にない場合は、先に nansen-wallet-manager スキルの Password Policy にあるセットアップ手順に従ってパスワードを生成し、保存してください。

注意事項

• クォートは約1時間で期限切れになります。実行に失敗した場合は、新しいクォートを取得してください。
• クォートの取得にもウォレットが必要です（API が送信元ウォレットに固有のトランザクションを作成します）。
• コンプライアンスチェック：trade quote と trade execute は、クォートのリクエストまたは署名の前に、Nansen API を通じて署名用ウォレット（および異なる --to-wallet の送信先が指定されている場合はその送信先）をコンプライアンス上のブロックリストと照合します。これは bridge と perp が実行する、同じフェイルクローズのチェックです。フラグが立てられたアドレスの場合、コード SANCTIONED で中止されます。スクリーニング呼び出し自体が失敗した場合は、コマンドが SCREENING_UNAVAILABLE で中止されます。どちらの場合も、署名もブロードキャストも行われません。
• ERC-20 のスワップでは、承認ステップが必要になることがあります。execute がこれを自動的に処理します。

パープ取引

Hyperliquid のパープ取引には nansen perp を使用します。DEX 取引と同じウォレットおよび NANSEN_WALLET_PASSWORD を使用します。EVM ウォレットが必要です。パープ注文は一度署名すると取り消せません。

サブコマンド：order、cancel、close、leverage、positions、orders、account、meta。

資産は --coin（例：BTC、ETH）で選択します。--symbol もエイリアスとして使用できます。取引可能な資産とその最大レバレッジを一覧表示するには、nansen perp meta を実行してください（最初の20件以外も表示するには、--filter <text> または --all を使用します）。

ポジションを開く

# Limit long: 0.1 ETH at $1600
nansen perp order --coin ETH --side buy --size 0.1 --price 1600 --type limit

# Market short with optional take-profit / stop-loss
nansen perp order --coin BTC --side sell --size 0.001 --price 95000 --type market \
  --take-profit 90000 --stop-loss 98000

• --side：buy／long でロングを開始し、sell／short でショートを開始します。
• --size：ベース資産単位でのポジションサイズ（正の数）。
• --price：指値価格（または成行注文の場合はマーク価格）。
• --type：limit（デフォルト）または market。--tif：Gtc（デフォルト）、Ioc、Alo。
• --slippage：成行注文用の [0,1] の小数（デフォルトは 0.03 = 3%）。

成功すると、コマンドは Hyperliquid の注文 ID（oid）と約定内容（サイズ @ 平均価格）を表示します。未約定のまま待機している注文の場合は、そのまま実行できる nansen perp cancel --coin <coin> --oid <oid> も表示します。付随するテイクプロフィット／ストップロス注文にはラベルが付けられ、それぞれ固有の oid が表示されます。

決済／キャンセル

# Close: sell to close a long, buy to close a short (validated against your open position)
nansen perp close --coin ETH --size 0.1 --price 1600 --side sell

# Cancel a resting order by id
nansen perp cancel --coin ETH --oid 123456

レバレッジ、資金移動、アカウント

nansen perp leverage --coin ETH --leverage 5 --margin-type cross   # or isolated
nansen perp transfer --direction spot-to-perp --amount 25          # or perp-to-spot
nansen perp positions
nansen perp account     # account value, unrealized PnL, margin used, withdrawable, spot USDC

--leverage は整数で指定する必要があり、資産の最大値が上限となります（perp meta を参照）。

スポットとパープ： パープ取引では Perps 残高を使用しますが、Hyperliquid の Send でウォレットに送られた USDC は Spot に入金され（perp account では Spot USDC と表示されます）、取引に使用する前に perp transfer --direction spot-to-perp --amount <usdc> で移動する必要があります。（ブリッジ経由の入金は直接 Perps に入ります。）

ソース

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

ブラウザーログインでは nansen:api を使用します。API キーと同じアカウント API 権限が適用され、既存のプラン、アカウント、エンドポイントのチェックも引き続き適用されます。取引には、別途設定されたウォレットとその署名認証が引き続き必要です。ホスト型シミュレーションでは、選択された認証情報は、信頼された Nansen API のオリジンと一致する場合にのみ使用されます。任意の RPC エンドポイントに Nansen の認証情報が送られることはありません。