SuperAPI AI 工具集

nansen-trade

智能体与模型

查看项目

更新于 10-16 01:34

技能介绍

用途:在 Solana 或 Base 链上执行 DEX 兑换,适用于买入或卖出代币、获取兑换报价、执行交易。采用两步流程:先报价,再执行;交易一旦上链不可撤销。

前提:需要先有钱包,交易前运行 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>。

智能体模式可将报价 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"。

常用代币地址:SOL(Solana)So11111111111111111111111111111111111111112;USDC(Solana)EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v;ETH(Base)0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee;USDC(Base)0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913。

金额以基础单位计:SOL 小数位 9,1 枚为 1000000000;ETH 小数位 18,1 枚为 1000000000000000000;USDC 小数位 6,1 枚为 1000000。

标志:--chain(solana 或 base)、--from(源代币符号或地址)、--to(目标代币符号或地址)、--amount(基础单位整数)、--wallet(钱包名,默认 default 钱包)、--slippage(滑点容差小数,如 0.03)、--quote(执行用报价 ID)、--no-simulate(跳过广播前模拟)。

环境变量:NANSEN_WALLET_PASSWORD 为执行交易所需,是钱包加密密码,持久化在 ~/.nansen/.env,执行前先 source ~/.nansen/.env && nansen trade execute ...;NANSEN_API_KEY 为 API 密钥,也可通过 nansen login 设置。智能体不应只在会话内存中保存钱包密码;若 ~/.nansen/.env 中没有 NANSEN_WALLET_PASSWORD,需按 nansen-wallet 技能的密码策略生成并持久化后再继续。

限制与注意:报价约 1 小时后过期,若执行失败需重新获取报价;即使仅报价也需要钱包,因为 API 会构建发送方特定交易;ERC-20 兑换可能需要授权步骤,execute 会自动处理。来源:npm https://www.npmjs.com/package/nansen-cli,GitHub https://github.com/nansen-ai/nansen-cli。