如何在OKX上为交易机器人创建API密钥？

访问API管理界面

1. 使用经过验证的凭据和两步身份验证登录您的 OKX 帐户。

2. 导航至右上角下拉菜单中的“帐户”部分。

3. 从侧边栏导航面板中选择“API 管理”。

4. 单击仪表板上显着位置的“创建 API”按钮。

5. 如果安全层提示，请通过电子邮件或短信确认您的身份。

配置API权限和限制

1.选择“交易”作为机器人操作涉及下单和管理的主要权限范围。

2. 启用“读取”访问权限以允许检索余额、头寸和市场数据，而无需执行权限。

3. 通过输入逗号分隔的 IPv4 地址或 CIDR 范围来指定 IP 白名单，以限制 API 调用来源。

4. 设置与您的登录密码不同的自定义密码，每个签名的请求都需要该密码。

5. 除非跨保证金或资产转移逻辑明确需要，否则关闭“提款”和“融资”权限。

生成并保护密钥对

1.提交配置后，OKX立即生成36个字符的UUID样式的API Key。

2. 32字节的十六进制Secret Key仅显示一次，以后无法检索，请立即复制。

3. 系统分配一个唯一的密码，该密码必须与其他两个凭据一起存储。

4. 每个经过身份验证的请求都需要所有三个值（API Key 、 Secret Key和Passphrase ）。

5. 切勿将这些值直接提交到源代码中；而是使用环境变量或加密的保管库。

本地测试 API 连接

1. 使用 python-okx 以及新创建的凭证和 flag=0（用于生产模式）初始化 TradeAPI 实例。

2. 执行最小余额查询： fundingAPI.get_balances(ccy='USDT')以验证签名有效性和端点可达性。

3. 监控 HTTP 状态代码 — 200 个响应确认身份验证和路由成功。

4. 观察速率限制标头（OK-RLIMIT-LIMIT、OK-RLIMIT-REMAINING）以校准机器人请求频率。

5. 使用 tdMode='cash' 和 sz='0.0001' 触发空运行限价订单，以验证订单验证逻辑，而无需实际执行。

与基于 Python 的交易基础设施集成

1. 通过 dotenv 从包含 OKX_API_KEY、OKX_SECRET_KEY 和 OKX_PASSPHRASE 条目的 .env 文件加载凭据。

2. 使用参数实例化 Trade.TradeAPI，其中包括用于演示模式的 false 和基于部署目标的正确标志值。

3. 在提交订单之前使用 MarketData.MarketAPI 获取实时行情，以避免过时的价格假设。

4. 将所有订单放置在 try- except 块中，捕获 okx.exceptions.OkxAPIException 以进行精细的错误处理。

5. 将带时间戳的请求/响应有效负载记录到旋转文件缓冲区，以进行执行后审核和延迟分析。

常见问题解答

问：我可以在多个机器人之间重复使用相同的 API 密钥吗？答：是的，但每个机器人都应在自己的专用密钥下运行，并具有定制的 IP 白名单和权限范围，以隔离故障影响。

问：如果我的密钥泄露会怎样？答：立即通过 API 管理界面撤销泄露的密钥并生成新的密钥，无需 OKX 支持人员进行手动干预。

问：OKX 是否强制执行密码短语轮换？答：不需要，但更改密码会使所有现有签名失效，并且需要在所有集成服务中重新初始化完整的凭据。

问：使用相同的 API Key 可以进行 WebSocket 连接吗？答：是的 - 尽管 WebSocket 订阅需要单独的主题注册，但相同的凭据可以对 REST 和 WebSocket 连接进行身份验证。