指南

使用 AI 搭建#

OnchainOS Market 为 Agent 和开发者提供统一的链上实时数据层——代币价格、交易活动、K 线图表、代币发现、钱包余额与交易历史,全部通过单一集成获取。既可作为交易执行的研究与监控层配合使用,也可独立用于构建投资组合看板和机会发现场景。

为什么为 AI 选择 OnchainOS Market#

双源价格聚合:Market Price 数据实时聚合自链上 DEX 交易活动与中心化交易所行情,比任何单一来源都能呈现更完整的代币真实市场价格。对于需要抗操纵参考价的 Agent(如止损阈值、风险参数、多步交易验证),Index Price API 通过多个独立第三方来源(CEX、DEX、预言机)计算稳定的合成价格,专门设计以抵抗单一来源的价格扭曲。

从发现到深度分析的完整代币情报:Token API 是一套完整的信息堆栈:按名称、符号或合约地址搜索代币;获取基础元数据(精度、合约地址);拉取实时交易指标(24 小时成交量、市值、流通供应量、持有人数、流动性);按涨幅、成交量或市值筛选热门代币;并可查看前 20 大持仓地址进行集中度分析。Agent 可以直接从用户的自然语言问题("今天以太坊上什么最热?")出发,在不离开工具的情况下得到结构化、可执行的答案。

一次调用获取完整持仓视图:Balance API 支持同时跨所有已支持链查询代币余额和 USD 投资组合总价值,无需逐链迭代。专为管理多链资产组合、或在执行兑换前需验证余额是否充足的 Agent 而设计。

支持分析与回测的完整 K 线历史:Market Price API 提供从分钟级到日线的 OHLCV 数据,历史 K 线接口可扩展回溯窗口,满足趋势分析、形态识别和策略回测需求。

面向 Agent 优化的接口 Skill 与 MCP Server:OKX Market 根据你的 Agent 部署方式提供两种集成路径。Skill 通过结构化指令和代码生成,教会你的 Agent 如何调用 OKX DEX API。MCP Server 则通过 Model Context Protocol,将相同的能力以可直接调用的工具形式对外暴露。

快速开始#

Skills#

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

npx skills add okx/onchainos-skills

MCP server#

适用于 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/onchainos-mcp",
      "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 能力。更新配置后重启客户端即可生效。