指南

使用 AI 搭建#

OnchainOS 交易为 Agent 和开发者提供完整的链上兑换执行支持方法——从获取最优多链报价到广播已签名交易,在这里可以找到一站式获取交易路由、签名与 RPC 的方法和指导。无论是构建自动交易 Agent,还是将兑换执行嵌入产品,Skill 和 MCP Server 均已内置生产级执行模式,覆盖使用 AI 辅助交易的完整流程。

为什么 AI Agent 需要 OnchainOS Trade#

广泛的链上流动性覆盖。OKX DEX 聚合器在 20+ 条链的 500+ 个 DEX 间进行路由,包括 Solana、Ethereum、Base、BNB Chain、Arbitrum、Sui、TON 等。报价时会将订单拆分至多个流动池和路由,以尽量弱化价格冲击、最大化实际到账金额,而不仅仅是寻找最便宜的单一路由。

一站覆盖完整执行链路。OnchainOS Trade 覆盖从quote → swap → 签名的每一步,Agent 只需一条最高意图指令即可完成多步兑换。

** Skills 或 MCP server 任你选择**。OnchainOS Trade 针对不同部署方式提供两种集成路径。Skill 内置结构化意图路由、各链执行 Playbook 和预置错误分类,Agent 无需从零摸索原始 API 的调用顺序,即可完整执行兑换流程。 MCP Server 则通过 Model Context Protocol 将全部交易能力暴露为可直接调用的工具,Claude Desktop、Cursor 等任何支持 MCP 的客户端均可自动发现并原生调用,无需任何额外接入代码。Agent 只需一句"把 0.1 ETH 换成 USDC",MCP Server 即可自动完成报价、交易组装、链上广播的完整链路。

快速开始#

将 Skill 文件添加至 Agent 的 skill 目录,Agent 将自动加载意图路由、各链执行 Playbook、签名模式及错误处理逻辑。

npx skills add okx/onchainos-skills

适用于 Claude Desktop、Cursor 及其他兼容 MCP 的客户端:

# for cursor
{
  "mcpServers": {
    "okx/onchainos-mcp": {
      "url": ""https://web3.okx.com/api/v1/onchainos-mcp"",
      "headers": {
        "OK-ACCESS-KEY": "your apiKey applyed on https://web3.okx.com/zh-hans/onchain-os/dev-portal/project"
      }
    }
  }
}
# for Claude code
{
  "mcpServers": {
    "okx/onchainos-mcp": {
      "url": "https://web3.okx.com/api/v1/mcp/dex",
      "headers": {
        "OK-ACCESS-KEY": "your apiKey applyed on https://web3.okx.com/zh-hans/onchain-os/dev-portal/project"
      }
      "type": "http"
    }
  }
}

一个 MCP Server 同时覆盖 Trade 和 Market 能力。更新配置后重启客户端即可生效。