Nansen Trade 命令行工具：Solana 与 Base 链代币交易指南与 API 使用

nansen-trade by nansen-ai/nansen-cli

122 周安装量

104 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/nansen-ai/nansen-cli --skill nansen-trade

区块链命令行工具 DeFi

🇨🇳中文介绍

交易

两步流程：先报价，后执行。交易一旦上链即不可逆转。

前提条件： 首先需要一个钱包。在交易前运行 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>

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

金额使用基础单位

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

标志	用途
`--chain`	`solana` 或 `base`
`--from`	源代币（符号或地址）
`--to`	目标代币（符号或地址）
`--amount`	基础单位数量（整数）
`--wallet`	钱包名称（默认：默认钱包）
`--slippage`	滑点容差，以小数表示（例如 0.03）
`--quote`	用于执行的报价 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 skill Password Policy 中的设置流程生成并持久保存一个密码，然后再继续。

报价约 1 小时后过期。如果执行失败，请获取新的报价。
即使报价也需要钱包（API 会构建特定于发送者的交易）。
ERC-20 代币交换可能需要授权步骤 — execute 会自动处理。

🇺🇸English

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.

Quote

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

Symbols resolve automatically: SOL, ETH, USDC, USDT, WETH. Raw addresses also work.

Execute

nansen trade execute --quote <quote-id>

Agent pattern

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

Common Token Addresses

Token	Chain	Address
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`

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)

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 skill Password Policy to generate and persist one before proceeding.

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.

Source

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

Weekly Installs

122

Repository

nansen-ai/nansen-cli

GitHub Stars

104

First Seen

Mar 1, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykWarn

Installed on

codex118

opencode117

kimi-cli116

gemini-cli116

github-copilot116

cursor116

Lark Drive API 使用指南：飞书云文档、Wiki、表格 Token 处理与文件管理

31,100 周安装