添加交易所 API
API Key 用于授权系统连接你的交易所账户。实盘跟单必须绑定已通过安全权限检查的 Key，模拟跟单则完全无需绑定。当前系统已支持 Binance 与 OKX，实际开放范围以你账户后台的选项为准。
绑定这件事值得认真对待：Key 的权限决定了产品在你账户里能做什么，也决定了万一泄露时别人能做什么。这一页按「创建 → 授权 → 绑定 → 撤销」四步讲完，并在每一步说明检查点。
绑定之前：先确认你是否真的需要
| 你现在的需求 | 需要绑定 Key 吗 |
|---|---|
| 浏览信号榜单、雷达、带单员报告 | 不需要 |
| 创建模拟跟单任务 | 不需要 |
| 创建实盘跟单任务 | 需要，且必须是权限合格的 Key |
| 只想先看看参数怎么填 | 不需要，模拟模式同样会走预检 |
如果页面提示「当前服务仅开放模拟跟单」，说明部署侧关闭了实盘，此时不需要也无法绑定 Key。这类提示来自服务端策略，不是你的账户设置问题。
在交易所创建 Key
在交易所官方账户的 API 管理页面创建用于 CopySonar 的 Key。创建入口和命名可能随交易所更新，请以其官方界面为准。保管好 API Key、Secret；OKX 还需要创建时设置的 Passphrase。
不要把这些内容复制到聊天、工单、截图或代码仓库中。此文档不提供真实凭据示例。
通用步骤
- 登录交易所官网，进入「API 管理」页面。只从官网或官方 App 进入，不要点击搜索广告或第三方链接。
- 新建 API Key，给它一个能让你自己认出来的备注（例如
copysonar-main）。备注会显示在 CopySonar 的 Key 列表里，方便区分。 - 在权限选项中只勾选读取与合约交易。提现、万向划转、内部划转一律不勾。
- 设置 IP 白名单，只填 CopySonar 绑定页展示的平台出口 IP。不要留空，也不要填
0.0.0.0/0。 - 完成交易所要求的安全验证（邮箱、短信、验证器或 Passkey），然后立刻把 Key、Secret（OKX 还要 Passphrase）录入 CopySonar 绑定表单。
关键点：Secret 和 Passphrase 通常在创建成功后只完整显示一次。请当场录入，不要先截图保存到相册或聊天记录里。
两个交易所的差异
| 项目 | Binance（U 本位合约） | OKX（永续合约） |
|---|---|---|
| 需要填写 | API Key + Secret | API Key + Secret + Passphrase |
| 权限名称 | 读取、允许合约 | 读取、交易 |
| 提现相关开关 | 「允许提现」必须关闭 | 「提币」必须关闭 |
| 划转相关开关 | 「允许万向划转」「允许内部划转」必须关闭 | 「划转」必须关闭 |
| 持仓模式要求 | 双向持仓 | 双向持仓 |
| IP 白名单 | 必须绑定 | 必须绑定 |
Passphrase 是创建 Key 时你自己设置的一串口令，不是登录密码，也不是交易所的二次验证码。忘记 Passphrase 时无法找回，只能在交易所删除该 Key 后重新创建。
TODO 素材：此处补「交易所 API 创建入口及用途选择，不展示任何凭据」截图
权限与 IP 白名单
只开启读取与合约交易权限，关闭提现、万向划转及内部划转。开启 IP 限制，仅填写登录后 API 管理页提供的平台出口 IP；不要猜测或复用旧地址。
绑定时由服务端校验权限。权限不符会拒绝绑定；交易所调整权限或 IP 后，请返回产品重新确认状态。
权限对照表
产品会逐项检查下面的开关，任何一项不符合都会拒绝绑定，并给出对应提示：
| 检查项 | 期望状态 | 不符合时的提示含义 |
|---|---|---|
| 读取权限 | 开启 | 没有读取权限就无法读取余额与持仓，无法计算仓位 |
| 合约交易权限 | 开启 | 没有合约权限就无法下单，实盘不可用 |
| 提现权限 | 关闭 | 开启提现等于把资金出口交给第三方，直接拒绑 |
| 万向划转 | 关闭 | 可在账户各钱包间转移资金，风险等同提现 |
| 内部划转 | 关闭 | 同上，属于资金搬运能力 |
| IP 白名单 | 已绑定且只含平台出口 IP | 未绑定白名单时，任何拿到 Key 的人都能调用 |
| 持仓模式 | 双向持仓 | 单向持仓模式下多空无法独立管理，跟单会错乱 |
关于出口 IP
- 平台出口 IP 只在登录后的绑定表单里展示，本文不列具体地址（地址可能随部署变化）。
- 一个 Key 的白名单里只填这一个 IP。多加公司出口、家庭宽带或旧地址都会扩大暴露面。
- 如果平台尚未配置固定出口 IP，绑定入口会提示暂不可绑定。这是保护措施，不是故障。
- 换 IP 后需要：交易所更新白名单 → 回 CopySonar 点「检查权限」重新校验。只改交易所不重新校验，任务仍会被阻断。
校验有效期
权限校验不是一次性的。Key 的成功校验结果有效期为 24 小时。过期后系统将停止开新仓（仍允许减仓与平仓），需要你回到 Key 管理页手动发起复检；复检通过后，还需在任务详情中手动点击恢复跟单。
TODO 素材：此处补「读取与合约交易开启、提现与划转关闭、出口 IP 白名单位置」截图
在 CopySonar 校验并绑定
打开 API Key 管理，选择交易所、填写账户备注与凭据；OKX 需额外填写 Passphrase。确认权限与 IP 白名单后提交校验。仅在页面明确显示绑定成功后，才继续选择实盘执行账户。
表单字段说明
| 字段 | 是否必填 | 说明与限制 |
|---|---|---|
| 交易所 | 必填 | Binance 或 OKX，选定后表单字段会变化 |
| 账户备注 | 选填 | 最多 128 字符，不能包含控制字符；留空时列表显示「未命名账户」 |
| API Key | 必填 | 建议完整粘贴，至少 8 个字符；表单不会回显完整值 |
| Secret | 必填 | 输入框默认隐藏，可点「显示」核对后再提交 |
| Passphrase | OKX 必填 | 创建 Key 时你设置的口令；Binance 不需要 |
提交前必须勾选确认项：你已关闭提现与划转、只开启读取和合约交易、IP 白名单只填平台出口 IP。这个勾选不是形式主义——它是你对自己授权范围的确认。
绑定过程发生了什么
- 凭据经加密后提交到服务端，界面不会保存明文。
- 服务端用这份 Key 向交易所发起只读请求，逐项读取权限与 IP 限制状态。
- 校验通过后 Key 状态变为「已校验」，并记录成功校验时间。
- 列表里会显示脱敏后的 Key 尾号、权限摘要、关联任务数与最近校验时间。
只有当列表显示「权限校验有效」时，这条 Key 才能被选为实盘执行账户。 状态为「待校验 · 已阻断」「权限失效 · 已阻断」「校验过期或未确认 · 已阻断」时，请先复检。
绑定失败的排查顺序
按这个顺序查，能覆盖绝大多数情况：
- Key 与 Secret 是否配套？ 混用了两个不同 Key 的 Secret 是最常见错误。
- OKX 是否漏填 Passphrase？ 或者填成了登录密码。
- 权限是否齐全？ 读取 + 合约交易缺一不可。
- 提现 / 划转是否关干净？ 万向划转和内部划转经常被忽略。
- IP 白名单是否只含平台出口 IP？ 未绑定或绑错都会失败。
- 持仓模式是否为双向？ 单向持仓会被拒绝。
- Key 是否已过期或被交易所停用？ 部分交易所会为 Key 设置有效期。
修正后直接重新提交即可，不要用同一份未修改的配置反复重试——连续失败不会让校验通过，只会浪费你的时间。详细错误对照见 API 绑定失败。
TODO 素材：此处补「绑定表单字段与权限校验结果，凭据字段全程遮挡」录屏
多账户与额度
- 每条实盘任务只能绑定一个执行账户；一个账户（Key）同一时间只能跑一条实盘任务。
- 绑定数量受套餐额度限制，达到上限时页面会提示先解绑闲置 Key。
- 列表支持按「全部 / 正常 / 需处理」筛选，也支持按名称搜索和按交易所筛选，账户多时用得上。
- 每条 Key 会显示它关联的未结束任务和已分配本金，方便你判断额度被谁占用。
解绑与撤销
有未结束关联任务时，先查看并处理任务，再尝试解绑。解除 CopySonar 绑定不会自动撤销交易所端的 Key；如需彻底撤销访问权限，还需到交易所删除对应 Key。
撤销可能影响已有仓位的后续管理。撤销前核对交易所订单与持仓，并阅读 异常处理。
两件不同的事
| 操作 | 在哪里做 | 效果 | 是否影响已有仓位 |
|---|---|---|---|
| 解除绑定 | CopySonar · API Key 管理 · 解绑 | 产品不再持有这份凭据，无法再代你下单 | 不会平仓；任务无法继续自动管理，需你自行处理仓位 |
| 撤销 Key | 交易所 · API 管理 · 删除 | 这份凭据彻底失效，任何持有者都无法调用 | 不会平仓；未平仓位仍在账户里 |
很多人以为「解绑 = 安全了」，但 Key 仍然在交易所侧有效。如果你怀疑凭据泄露，必须去交易所删除 Key，而不是只解绑。
解绑前的检查清单
- [ ] 这条 Key 没有未结束的关联任务（有的话页面会阻止解绑）。
- [ ] 已确认该账户在交易所的持仓与挂单，必要时先手动平仓。
- [ ] 你清楚解绑后任务将无法继续自动管理。
- [ ] 如果目的是彻底收回权限，记得再去交易所删除 Key。
什么时候应该立即撤销
出现以下任一情况，先在交易所删除 Key，再回来处理任务与账户：
- 凭据可能出现在截图、聊天记录、日志或代码仓库中。
- 交易所提示异地登录、异常 API 调用或权限被修改。
- 你发现账户里有自己没下过的订单。
- 你不再使用本产品，且账户里仍有持仓。
具体处置顺序见 异常时如何处理。
下一步
- 绑定成功，开始配置任务：创建跟单 · 字段说明
- 想知道权限为什么这么设计：安全 / 资金说明
- 绑定失败：FAQ · API 绑定失败