AI Builder Program 接入指南

项目简介

通过OKX 交易功能接入你的 AI 产品。用户通过你的产品完成符合条件的交易后，你可以按规则获得返佣，最高 50%

整个流程只需要四步：

提交申请 -> 完成接入 -> 模拟盘测试 -> 上线

第一步：提交申请

1. 进入 AI Builder Program 申请页面；

2. 点击“立即申请”，选择 AI Builder；

3. 填写项目名称、项目链接和简单介绍；

4. 接受适用条款并提交；审核预计一到两个工作日通过

审核期间可以先完成安装和测试。Builder Code 何时生效、返佣从何时开始计算，以控制台状态和适用协议为准。

第二步：联调并接入OKX交易能力

重要资源链接：

集成demo链接：

https://github.com/okx/builder-integration-demo

API集成指引链接（你可以让你的agent读取）：
https://github.com/okx/ai-builder-openapi-md

选择接入方式：

以下是详细接入流程：

MCP接入

Step 1 - 确认工具能力
选择支持 aiBuilderCode 参数的 OKX MCP 下单工具，并确认所需交易产品和操作均在支持范围内。

Step 2 - 集成 Builder Code
在 Agent 或 Skill 调用下单工具时，自动将获批的 AI Builder Code 写入 aiBuilderCode 参数，无需终端用户手动填写。

Step 3 - 完成用户授权
引导用户在 MCP Host 或 OKX Connector 中连接并授权自己的 OKX 账户。账户凭证由 Host 或 Connector 管理，Builder 不应获取或保存用户的 API 凭证。

Step 4 - 测试并核对归因
先通过模拟盘完成连接、余额查询和小额订单测试，再核对订单是否成交，以及 AI Builder 工作台是否识别到对应交易。

CLI接入

适用于 Builder 开发并分发本地策略、Coding Agent Skill、自动化脚本或企业自托管工具。

Step 1 - 封装 CLI
在 Builder 的 Skill、脚本或 Agent 中调用 OKX Trade CLI，并明确所需的行情、账户及下单命令。

Step 2 - 检查归因参数
使用支持 --aiBuilderCode 的最新 CLI 版本，并确认目标下单命令的帮助信息中包含该参数。

Step 3 - 完成本地账户配置
引导用户在自己的设备、VPS 或自托管环境中配置 API Key Profile，或完成 CLI OAuth 授权。账户凭证仅保存在用户环境中，Builder 不接触用户密钥。

Step 4 - 自动带入 Builder Code
所有需要归因的下单命令都应自动加入：

--aiBuilderCode <AI_BUILDER_CODE>

不要改用 tag、--ai-builder-code 或其他参数。

Step 5｜测试并核对归因
先使用模拟盘运行小额订单，确认命令执行、订单成交及工作台归因正常后，再准备实盘上线。

API接入

适用于 Builder 将 OKX OpenAPI 直接集成到交易机器人、策略系统、SDK 或其他产品中。

Step 1 - 提供账户绑定入口
由用户创建 OKX API Key（请登录后，访问：https://www.okx.com/account/my-api），并在 Builder 产品或用户自托管环境中完成账户绑定。API Key 应只开启必要的读取和交易权限，不开启提币权限。

Step 2 - 安全管理凭证
API Key、Secret Key 和 Passphrase 必须保存在安全的本地环境或 Builder 后端，并进行加密和用户隔离，不得出现在前端、提示词、日志或代码仓库中。

Step 3 - 完成 OpenAPI 集成
根据 OKX OpenAPI 文档实现请求签名、账户查询和交易下单，并根据用户所属站点选择正确的 API 域名及接口。

详情见：https://github.com/okx/ai-builder-openapi-md

Step 4 - 写入 Builder Code
在支持归因的 OpenAPI 下单请求中，将 AI Builder Code 写入：

{
"tag": "<AI_BUILDER_CODE>"
}

直接调用 OpenAPI 时使用的是 tag，不是 aiBuilderCode。

Step 5 - 测试并核对归因
先使用模拟盘完成连接、签名、下单和成交测试，再检查 AI Builder 工作台是否成功识别对应交易。

Oauth 接入

开始前：

Step 1 - 需要进入工作台设置你的Oauth & Fast API 信息，访问：https://www.okx.com/agent-tradekit/builder

Step 2 - 点击 设置 完成信息填写

Step 3 - 完成所有的内容填写

第一步 - 填写你的应用名称，以及上传oauth logo，这一步在申请时已经完成，不过你可以在这里编辑变更内容

第二步 - 输入 URLs 和 Oauth 免鉴权 IP 地址 （最多支持10个IP 地址）

第三步 - 可以选择打开Fast API，输入您的app 名字，以及输入用户关联的IP地址（最多支持200个 IP 地址）

Step 1 - 先获取 您的 client _ secret 和 client_id ，再用两项帮助您的用户，创建API key

如何获取您的clientsecret和clientid？确认邮箱后，就会收到对应的passkeys。注意：API Key、Secret Key 和 Passphrase 必须保存在安全的本地环境或 Builder 后端，并进行加密和用户隔离，不得出现在前端、提示词、日志或代码仓库中。

Step 2 - 帮助您的用户，完成oauth后，就能创建fast api key，接着就可以使用fastapi。选择使用第三方APP，找到对应的APP name，即可以关联；

第三步：小额测试上线

上线前确认：

• Builder Code 的控制台状态符合要求，请前往：https://www.okx.com/zh-hans/agent-tradekit/builder

• 使用支持 aiBuilderCode的下单方式，详情参考本文第二步

上线时先完成一笔小额实盘测试，然后依次检查：

1. 订单是否成功提交 & 订单是否实际成交；

2. 控制台是否识别到来自你产品的交易，点击进入 更多数据

3. 返佣是否按适用规则计算。

Note：

下单成功，不代表订单已经成交；订单成交，也不代表已经计算返佣。

如果控制台没有识别到对应交易，请先停止扩大交易量，再检查 Builder Code、ATK 版本和下单方式。

接入 AI Builder Program 不代表一定可以获得返佣，也不代表交易一定会盈利。实际返佣资格、比例和金额，以 AI Builder 控制台、最新规则和适用协议为准。

常见问题

1. 谁可以申请成为 AI Builder，有什么门槛？
   所有用 AI 搭建交易项目的个人和团队都可以申请，包括 AI Agent、交易机器人、Skill 插件、开源工具、数据应用。无论项目处于原型阶段还是已有使用用户。

2. 返佣比例是多少？怎么计算的？
   按 Builder 等级返佣，申请通过即享 35% 返佣比例，最高可达 50%。返佣按VIP3以下用户的合格交易产生的净手续费乘以返佣比例计算，新老用户均计入。详见 https://www.okx.com/help/ai-builder-program-commission-rules 。

3. 已有节点邀请关系，还能获得 AI Builder 返佣吗？

   1. 可以。节点邀请用户通过 AI Builder 产生的符合条件的交易，仍可计入 AI Builder 返佣。返佣金额根据符合条件的交易所产生的净手续费 × AI Builder 对应的返佣比例计算，返佣规则详见 https://www.okx.com/help/ai-builder-program-commission-rules

4. 从申请到开始赚返佣需要多久？
   提交申请后立刻拿到 Builder Code，即可开始接入联调。审核通过并激活后，合格交易即计入返佣，每小时结算一次

5. 怎么接入？需要改我现有的交易逻辑吗？
   四种方式任选：MCP（AI 客户端即插即用)、CLI（脚本命令)、API（用户API Key登录），Oauth（用户OKX授权登录）。官方提供 AI Skill 和 Demo 帮助快速接入，并支持 OKX 授权登录。只需在交易调用中带上你的 Builder Code，无需改动策略与交易逻辑

6. 返佣什么时候到账？如何结算？
   T+1 小时 自动结算一次，以 USDT 发放至 Builder Code 绑定账户。Dashboard 可实时查看每笔归因与返佣明细