什么是 Nansen Trade？

Nansen Trade 技能赋予开发人员和 AI 智能体精确执行链上代币兑换的能力。通过与 Nansen 生态系统集成，该技能为在 Solana 和 Base 等主要网络上进行报价和执行交易提供了流线型接口。它是 Openclaw Skills 生态系统中构建自动化金融智能体的核心组件。

该工具处理去中心化交易的复杂性，包括代币地址解析和自动 ERC-20 授权，确保程序化交易既易于访问又高效。使用此类 Openclaw Skills 可以在安全、受控的环境中实现基于逻辑的交易策略，弥合了高级智能体指令与低级区块链执行之间的差距。

下载入口:https://github.com/openclaw/skills/tree/main/skills/hurcannansen/nansen-trade

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

2. 手动安装

将技能文件夹复制到以下位置之一

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

Nansen Trade 应用场景

• 在 Solana 或 Base 网络上自动平衡加密资产组合。
• 通过自主 AI 智能体执行基于逻辑的交易或限价单。
• 将去中心化交易所兑换功能集成到自定义 CI/CD 或 DevOps 工作流中。
• 在开发过程中快速获取用于 Gas 费或智能合约交互的代币。

1. 确保已使用必备的钱包创建命令初始化并配置了钱包。
2. 通过指定源代币、目标代币、金额和网络链生成交易报价。
3. 从命令响应中提取唯一的报价 ID (Quote ID)，用于最后的执行步骤。
4. 使用报价 ID 执行交易，该操作将签名并将交易广播到区块链。
5. 可选择利用智能体模式，将报价输出直接通过管道传输到执行步骤，实现无缝自动化。

Nansen Trade 配置指南

安装 nansen-cli 包并确保 nansen 二进制文件在您的路径中。这是 Openclaw Skills 库中此条目的主要要求。

npm install -g nansen-cli

使用必要的 API 密钥和钱包密码配置您的环境。

export NANSEN_API_KEY="your_api_key_here"
export NANSEN_WALLET_PASSWORD="your_secure_password"
# 将密码持久化到 nansen 目录中以便智能体访问
echo "NANSEN_WALLET_PASSWORD=$NANSEN_WALLET_PASSWORD" >> ~/.nansen/.env
source ~/.nansen/.env

Nansen Trade 数据架构与分类体系

该技能使用结构化输入进行链选择和代币识别。金额必须以基础单位（整数）提供，以符合 Openclaw Skills 中特定代币的链上精度要求。

name: nansen-trade
description: Execute DEX swaps on Solana or Base. Use when buying or selling a token, getting a swap quote, or executing a trade.
metadata:
  openclaw:
    requires:
      env:
        - NANSEN_API_KEY
        - NANSEN_WALLET_PASSWORD
      bins:
        - nansen
    primaryEnv: NANSEN_API_KEY
    install:
      - kind: node
        package: nansen-cli
        bins: [nansen]
allowed-tools: Bash

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 r
  --chain solana r
  --from SOL r
  --to USDC r
  --amount 1000000000

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

Execute

nansen trade execute --quote 

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

Amounts are in base units

Flags

Environment Variables

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.