Back to Details

nansen-trading

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Trade

交易

Two-step flow: quote then execute. Trades are irreversible once on-chain.
Prerequisite: You need a wallet first. Run 
nansen wallet create
before trading.
两步流程：先获取报价，再执行交易。交易上链后不可撤销。
前置条件： 你需要先拥有一个钱包。在交易前运行
nansen wallet create
命令。

Quote

获取报价

bash
nansen trade quote \
  --chain solana \
  --from SOL \
  --to USDC \
  --amount 1000000000
Symbols resolve automatically: 
SOL
, 
ETH
, 
USDC
, 
USDT
, 
WETH
. Raw addresses also work.
bash
nansen trade quote \
  --chain solana \
  --from SOL \
  --to USDC \
  --amount 1000000000
代币符号会自动解析：
SOL
、
ETH
、
USDC
、
USDT
、
WETH
。直接使用代币地址也可以。

Execute

执行交易

bash
nansen trade execute --quote <quote-id>
bash
nansen trade execute --quote <quote-id>

Agent pattern

Agent模式

bash
undefined
bash
undefined

Pipe quote ID directly into execute

直接将报价ID传入执行命令

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"
undefined
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"
undefined

Common Token Addresses

常用代币地址

TokenChainAddress
SOLSolana
So11111111111111111111111111111111111111112
USDCSolana
EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
ETHBase
0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee
USDCBase
0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
代币链地址
SOLSolana
So11111111111111111111111111111111111111112
USDCSolana
EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
ETHBase
0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee
USDCBase
0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

Amounts are in base units

金额以基础单位计算

TokenDecimals1 token =
SOL9
1000000000
ETH18
1000000000000000000
USDC6
1000000
代币小数位数1代币 =
SOL9
1000000000
ETH18
1000000000000000000
USDC6
1000000

Flags

参数选项

FlagPurpose
--chain
solana
or 
base
--from
Source token (symbol or address)
--to
Destination token (symbol or address)
--amount
Amount in base units (integer)
--wallet
Wallet name (default: default wallet)
--slippage
Slippage tolerance as decimal (e.g. 0.03)
--quote
Quote ID for execute
--no-simulate
Skip pre-broadcast simulation
选项用途
--chain
指定链：
solana
或 
base
--from
源代币（符号或地址）
--to
目标代币（符号或地址）
--amount
金额（基础单位，整数）
--wallet
钱包名称（默认：默认钱包）
--slippage
滑点容忍度（小数形式，例如0.03）
--quote
执行交易所需的报价ID
--no-simulate
跳过广播前的模拟步骤

Environment Variables

环境变量

VarPurpose
NANSEN_WALLET_PASSWORD
Required for 
trade execute
. Wallet encryption password — persisted in 
~/.nansen/.env
. Source before executing: 
source ~/.nansen/.env && nansen trade execute ...
NANSEN_API_KEY
API key (also set via 
nansen login
)
Agents: Never hold a wallet password only in session memory. If 
NANSEN_WALLET_PASSWORD
is not in 
~/.nansen/.env
, follow the setup flow in the nansen-wallet-manager skill Password Policy to generate and persist one before proceeding.
变量用途
NANSEN_WALLET_PASSWORD
执行
trade execute
时必填。 钱包加密密码 — 会持久化存储在
~/.nansen/.env
中。执行前先加载：
source ~/.nansen/.env && nansen trade execute ...
NANSEN_API_KEY
API密钥（也可通过
nansen login
命令设置）
Agent提示： 切勿仅在会话内存中存储钱包密码。如果
NANSEN_WALLET_PASSWORD
未保存在
~/.nansen/.env
中，请遵循nansen-wallet-manager技能的密码策略中的设置流程，生成并持久化存储密码后再继续操作。

Notes

注意事项

  • Quotes expire after ~1 hour. If execute fails, get a fresh quote.
  • A wallet is required even for quotes (the API builds sender-specific transactions).
  • ERC-20 swaps may require an approval step — execute handles this automatically.
  • 报价约1小时后过期。如果执行交易失败，请获取新的报价。
  • 即使是获取报价也需要钱包（API会构建与发送方相关的交易）。
  • ERC-20代币兑换可能需要授权步骤 — 执行命令会自动处理此操作。

Source

源码地址