OKX Agent Trade Kit
OKX 官方本地 Agent 交易工具集，提供 MCP、CLI 与 Skills，将行情、账户和交易接口接入 AI 工作流，支持只读及 demo 环境。
开发工具 · 仓库资料已读 · 资料日期 2026-10-13
官方入口 ↗适合场景与使用门槛
开发自己的 Agent · 寻找交易助手 · 获取市场数据。需要开发与部署能力，MCP / CLI / Skills。
本地 MCP／CLI／Skills
适合谁
- 使用 MCP / CLI 开发 OKX 研究或交易工作流的技术用户。
主要限制
- 工具免费不等于模型和交易免费。
- 读过防护说明不代表已验证其实现；实盘前需单独核对权限和环境。
第一次怎么用
安装完成后的只读示例：okx market ticker BTC-USDT。先确认返回标的与时间，再考虑 test / demo 工作流。
本地工具需要配置环境；网站指南与仓库版本可能不同，命令以当前 README 为准。
费用与使用条件
官方 FAQ 明确工具免费，MIT 开源。
免费范围：公开行情无需 API Key；只读和 demo 是配置模式，不是收益试用。
其他成本：AI 客户端 / 模型用量、实际交易手续费和持仓成本另计。
核验 2026-10-13 · OKX · Agent Trade Kit 官方指南 / FAQ ↗ · OKX · Agent Trade Kit 当前 README ↗
官方能力描述
- OKX 官方本地 Agent 交易工具集，提供 MCP、CLI 与 Skills，将行情、账户和交易接口接入 AI 工作流，支持只读及 demo 环境。
OKX · Agent Trade Kit ↗
执行与资金权限
通过本地工具调用 OKX API；交易权限、模块和环境由操作者配置。
API Key 本地配置；只读、模块过滤与模拟交易是官方控制选项，不代表所有组合都安全。
观察与证据缺口
已阅读所列公开资料，观察限于页面与仓库内容；未注册或执行交易。
编辑判断：适合比较工具覆盖、权限配置与模拟环境；须区分 OKX 链上产品。
- readonly、模块过滤和 demo 配置能否同时生效
- 本地 API Key 保存、工具输出及日志的敏感信息边界
- 各模块覆盖、版本更新与写入确认行为
REA REVERSE ENGINEERING
逆向工程 · 公开证据分析
实际发布的 MCP 核心包按业务模块和只读配置生成工具集合，并区分模拟与实盘配置；客户端工具过滤不替代交易所账户权限。
npm @okx_ai/okx-trade-mcp@1.4.8 的选定发布文件；REA 解析 1 个 JS 文件，静态分析。 · 2026-10-13 · REA 6.4.0
只读开关实际过滤写工具 实际观察
buildTools 在 readOnly 启用时过滤 isWrite 工具；MCP 列表和调用映射基于筛选后的集合，未找到的工具返回 unknown-tool 结果。该版本存在真实代码约束，不只是 readOnlyHint 提示。
凭据、模拟模式与用户确认属于不同层 代码推断
代码读取完整 API key / secret / passphrase 组合，也支持 OAuth 状态；--demo 对应模拟交易请求头。普通工具派发直接调用 handler，错误补救中的“先确认再写入”主要以服务端 instructions 和提示表达，不能视为逐笔独立审批器。
分析范围与限制
- 范围是 @okx_ai/okx-trade-mcp@1.4.8 的 dist/index.js；没有运行安装钩子或启动 MCP。
- 没有验证账户 API 权限、区域站点、远端额度控制或模拟与实盘实际可用性。
- 静态代码不证明运行行为、完整风控、成交或收益；未审计服务端。
- 没有登录、读取账户、连接钱包、签名、交易或执行目标代码。
资料来源
OKX · Agent Trade Kit ↗ · OKX · Agent Trade Kit 官方指南 / FAQ ↗ · OKX · Agent Trade Kit 当前 README ↗
适用场景为编辑判断；独立金融能力实测未完成。
补充或纠正这份档案