Back to Details

nansen-trade

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
, 
BNB
, 
USDC
, 
USDT
, 
WETH
, 
WBNB
. Raw addresses also work.
bash
nansen trade quote \
  --chain solana \
  --from SOL \
  --to USDC \
  --amount 1000000000
代币符号会自动识别：
SOL
、
ETH
、
BNB
、
USDC
、
USDT
、
WETH
、
WBNB
。也支持直接使用原生地址。

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
, 
ethereum
, 
base
, or 
bsc
--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
、
ethereum
、
base
、或
bsc
--from
源代币（符号或地址）
--to
目标代币（符号或地址）
--amount
基础单位计价的金额（整数）
--wallet
钱包名称（默认：默认钱包）
--slippage
滑点容忍度，用小数表示（例如0.03）
--quote
执行交易所需的报价ID
--no-simulate
跳过广播前的模拟验证

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兑换可能需要授权步骤——执行命令会自动处理该步骤。