关于 nansen-trade
nansen-trade 是通过 Nansen CLI 准备并执行代币兑换的技能,采用先报价、再执行的流程。它接受代币符号或地址;即使只获取报价,也需要钱包。
主要功能
- 01获取支持链上的兑换报价
- 02通过符号或地址指定代币
- 03使用报价 ID 执行交易
- 04设置滑点容忍度
- 05广播前模拟交易
适用场景
- 01兑换代币前获取报价
- 02使用有效报价执行兑换
- 03通过模拟预览交易
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ nansen-ai/ nansen-cli --skill nansen-trade安装后在 Claude Code 中输入/nansen-trade确认已加载。
详细介绍
交易
两步流程:先获取报价,再执行。交易一旦上链便不可撤销。
前提条件: 你需要先创建钱包。交易前运行 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>
Agent 模式
# 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 | 钱包名称(默认:默认钱包) |
--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 设置) |
Agents: 切勿只将钱包密码保存在会话内存中。如果
~/.nansen/.env中没有NANSEN_WALLET_PASSWORD,请先按照 nansen-wallet 技能中的密码策略完成设置,生成并保存密码后再继续。
说明
- 报价约 1 小时后过期。如果执行失败,请重新获取报价。
- 即使只获取报价也需要钱包(API 会构建针对发送方的交易)。
- ERC-20 兑换可能需要授权步骤,执行时会自动处理。
来源
评论
支持 Markdown