添加交易所API
了解如何在各交易所创建 API Key 并将其绑定到 BeeQuant 平台，以实现自动化交易。
一 概述
交易所 API（Application Programming Interface）是连接 BeeQuant 与交易所的桥梁，在策略信号触发时自动调用交易所接口（API）完成下单、查询等操作，实现端到端的全自动量化交易。
什么时候需要 API？
回测 — 不需要
模拟 — 不需要
实盘 / 测试网 — 必须绑定
安全说明：BeeQuant 使用加密方式存储你的 API Key， 且仅用于策略交易操作。我们不会使用你的 API Key 进行任何非授权操作。建议只开启交易权限，禁止开启提现权限。
二 支持的交易所
BeeQuant 目前支持以下主流交易所，后续将持续接入更多交易所。
B
Binance（币安）
全球最大加密货币交易所
现货U本位合约币本位合约
需要凭证：API Key + Secret Key
O
OKX（欧易）
知名加密货币交易平台
现货U本位合约币本位合约
需要凭证：API Key + Secret Key + Passphrase
📢 更多交易所（Bybit、Gate.io 等）支持持续开发中，敬请期待。
三 创建 API Key
在交易所创建 API Key 后绑定到 BeeQuant，平台即可代你执行交易。以下是各交易所的详细操作指南。
B
3.1 Binance 配置指南
1
登录 Binance 账户
访问 binance.com 并登录你的账户。需已完成身份验证（KYC）。
2
进入 API 管理页面
点击右上角头像 → 「API 管理」，或直接访问 binance.com/cn/my/settings/api-management。
3
创建 API Key
点击「创建API」→ 选择「系统生成」类型 → 输入标签名（如
BeeQuant）→ 完成安全验证。4
配置权限
根据你的策略需求勾选对应权限：
✓允许现货和杠杆交易（现货策略必选）
✓允许合约交易（合约策略必选）
✗不要勾选「允许提现」权限
5
设置 IP 白名单（推荐）
在「限制只能从受信任 IP 访问」中添加你的服务器 IP 地址。在 BeeQuant 平台租用服务器后， 可在服务器管理页面查看 IP 地址。如果暂不设置，可先选择「不限制」，后续再补充。
6
保存 API Key 和 Secret Key
创建成功后，请立即保存 API Key 和 Secret Key。 Secret Key 仅显示一次，关闭页面后无法再次查看。 如果遗失需重新创建。
O
3.2 OKX 配置指南
1
登录 OKX 账户
访问 okx.com 并登录，确保已完成身份认证。
2
进入 API 管理
点击头像 → 「API」，进入 API 管理页面。
3
创建 V5 API Key
点击「创建 V5 API Key」，填写以下信息：
•API 名称：自定义名称（如 BeeQuant）
•密码短语（Passphrase）：设置一个密码，后续绑定时需要输入
•权限：选择「交易」权限
4
设置 IP 白名单（推荐）
与 Binance 相同，建议添加服务器 IP 到白名单以增强安全性。
5
保存三项凭证
OKX 的 API 需要三项凭证才能使用，请务必全部保存：
①API Key
②Secret Key
③Passphrase（密码短语）
四 API 凭证说明
不同交易所需要的凭证字段有所不同，以下是详细说明：
| 字段 | 说明 | Binance | OKX |
|---|---|---|---|
| API 名称 | 自定义名称，用于在平台内区分不同的 API | 必填 | 必填 |
| API Key | 交易所生成的公钥，用于标识你的身份 | 必填 | 必填 |
| Secret Key | 交易所生成的私钥，用于签名请求。仅创建时显示一次 | 必填 | 必填 |
| Passphrase | OKX 独有的密码短语，创建 API 时自行设定 | — | 必填 |
五 绑定到平台
获取到 API Key 后，在 BeeQuant 平台完成绑定：
1
进入交易所管理页面
在左侧导航栏点击「交易所」，进入交易所管理页面。
2
点击「添加交易所」
点击页面右上角的「添加交易所」按钮，进入API 配置页面。
3
选择交易所
在页面顶部选择对应的交易所（Binance / OKX），系统会自动显示该交易所需要的表单字段。
4
填写 API 信息
输入以下字段：
•名称：给 API 起一个便于识别的名称（如 "Binance 主账户"）
•API Key：从交易所复制的公钥
•API Secret：从交易所复制的私钥
•Passphrase（仅 OKX）：创建 API 时设定的密码短语
5
提交并验证
点击「添加交易所」按钮提交。系统会自动验证 API 连接是否正常。验证通过后， 你可以在交易所管理页面看到已绑定的交易所和账户余额信息。
💡 提示：绑定成功后，你可以在部署实盘策略时的交易引擎节点中选择已绑定的账户进行交易。
六 权限配置详解
根据你的策略类型，需要开启不同的 API 权限：
| 策略类型 | Binance 需要的权限 | OKX 需要的权限 |
|---|---|---|
| 现货策略 | 允许现货和杠杆交易 | 交易 |
| U本位合约策略 | 允许合约交易 | 交易 |
| 币本位合约策略 | 允许合约交易 | 交易 |
| 混合策略 | 现货 + 合约交易 | 交易 |
⚠️ 重要安全提醒：任何情况下都不要开启提现权限。 BeeQuant 平台仅需要交易权限即可正常运行，开启提现权限会增加资金被盗风险。
七 安全建议
禁止开启提现权限
API Key 只需要交易权限即可，开启提现权限会增加资金被盗风险。
设置 IP 白名单
将服务器 IP 加入交易所 API 的白名单，限制只有指定 IP 才能使用该 API。
妥善保管密钥
不要将 API Key 和 Secret Key 分享给任何人，不要在公开场所（如 GitHub、论坛）暴露密钥信息。
定期轮换密钥
建议每 3-6 个月更换一次 API Key，降低长期使用的安全风险。轮换后记得在平台更新。
独立 API 隔离
建议为不同策略创建独立的 API Key，一旦某个 API 出现异常可以单独禁用而不影响其他策略。
异常及时处理
发现可疑交易活动时，第一时间在交易所禁用或删除 API Key，并修改账户密码。
常见问题
Q: API 连接验证失败怎么办？
A: 请逐项检查：① API Key 和 Secret Key 是否正确复制（注意无多余空格）； ② API 权限是否已开启交易权限；③ 如设置了 IP 白名单，确认服务器 IP 已添加； ④ OKX 用户检查 Passphrase 是否正确；⑤ 确认 API Key 未过期或被禁用。
Q: 一个交易所可以绑定多个 API Key 吗？
A: 可以。你可以为同一个交易所绑定多个 API Key（使用不同名称区分），便于不同策略使用独立的 API 进行风险隔离。
Q: 修改交易所 API 权限后需要重新绑定吗？
A: 如果只是修改权限（如增加合约交易权限），API Key 不变则无需重新绑定。 如果重新生成了 API Key，则需要在平台中删除旧的并重新添加。
Q: Secret Key 丢失了怎么办？
A: Secret Key 仅在创建时显示一次，无法找回。你需要在交易所删除该 API Key 并重新创建一个新的， 然后在 BeeQuant 平台更新绑定信息。
Q: 子账户的 API 可以使用吗？
A: 支持。如果你使用的是交易所子账户创建的 API Key，同样可以绑定到 BeeQuant 使用。 子账户可以有效隔离策略资金，是推荐的安全实践。