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

常用代币地址

Token	Chain	Address
SOL	Solana	`So11111111111111111111111111111111111111112`
USDC	Solana	`EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v`
ETH	Base	`0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee`
USDC	Base	`0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913`

代币	链	地址
SOL	Solana	`So11111111111111111111111111111111111111112`
USDC	Solana	`EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v`
ETH	Base	`0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee`
USDC	Base	`0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913`

Amounts are in base units

金额以基础单位计算

Token	Decimals	1 token =
SOL	9	`1000000000`
ETH	18	`1000000000000000000`
USDC	6	`1000000`

代币	小数位数	1代币 =
SOL	9	`1000000000`
ETH	18	`1000000000000000000`
USDC	6	`1000000`

Flags

参数选项

Flag	Purpose
`--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

环境变量

Var	Purpose
`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

源码地址

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

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