nansen-trade

取引

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

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

見積もり

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

シンボルは自動的に解決されます：SOL、ETH、USDC、USDT、WETH。生のアドレスも使用できます。

実行

nansen trade execute --quote <quote-id>

エージェントのパターン

# 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

金額は基本単位で指定します

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

フラグ

フラグ	目的
--chain	solana または base
--from	送信元トークン（シンボルまたはアドレス）
--to	送信先トークン（シンボルまたはアドレス）
--amount	基本単位での金額（整数）
--wallet	ウォレット名（デフォルト：default wallet）
--slippage	スリッページ許容値（小数、例：0.03）
--quote	execute 用の見積もり ID
--no-simulate	ブロードキャスト前のシミュレーションをスキップ

環境変数

変数	目的
NANSEN_WALLET_PASSWORD	trade execute に必須です。 ウォレットの暗号化パスワードです。~/.nansen/.env に保存されます。実行前に読み込みます：source ~/.nansen/.env && nansen trade execute ...
NANSEN_API_KEY	API キー（nansen login でも設定できます）

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

注意事項

• 見積もりは約 1 時間で期限切れになります。実行に失敗した場合は、新しい見積もりを取得してください。
• 見積もりの場合でもウォレットが必要です（API が送信者固有のトランザクションを構築するため）。
• ERC-20 のスワップでは承認手順が必要になる場合があります。承認は実行時に自動的に処理されます。

ソース

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