只读 + 合约权限
去绑定 →
三条安全原则
API 密钥相当于「受限的账户密码」。按下面三条配置，即使密钥泄露，别人也无法转走你的资金。
永远不要开启提现权限
系统只需要读取持仓和下单，任何要求你开「提现 / Withdraw」的教程都不要照做。
只开「读取」+「合约交易」
读取用于展示持仓与盈亏，合约交易用于等比跟单；现货、划转、理财权限一律不需要。
务必绑定 IP 白名单
只允许部署机器的公网出口 IP 调用，密钥即使泄露也无法从别处使用。
▲
Secret 只显示一次。创建完成后立即存入密码管理器；不要截图发微信 / Telegram，不要提交到 Git，也不要写在便签里。若怀疑泄露，直接到交易所删除该 Key 并重建（不影响历史订单与已跟单仓位）。
分交易所图文步骤
选择你使用的交易所。四个平台的入口名称略有差异，但逻辑完全一致：创建 → 配权限 → 绑 IP → 存密钥。
权限对照表
各平台勾选项名称不同，按下表对照即可。打 ✓ 的必须开，打 ✕ 的绝对不要开。
| 能力 | 币安 | Gate | 欧易 OKX | Bybit | 用途 |
|---|---|---|---|---|---|
| 读取账户 / 持仓 | 读取 | 读取 | 读取 | Read-Only | 展示余额、持仓与盈亏 |
| 合约下单 / 平仓 | 允许合约 | 合约交易 | 交易 | Contract · Trade | 等比跟单、手动同步、平仓 |
| 调整杠杆 | 随合约权限 | 随合约权限 | 随交易权限 | 随 Contract | 建规则时可选设置 |
| 提现 / Withdraw | ✕ 禁止 | ✕ 禁止 | ✕ 禁止 | ✕ 禁止 | 系统永远用不到 |
| 划转 / 内部转账 | 不需要 | 不需要 | 不需要 | 不需要 | 资金留在合约账户即可 |
| 现货 / 杠杆交易 | 可选 | 可选 | 可选 | 可选 | 只做合约时不必开 |
i
如果暂时只想看信号、不自动下单，可以只开读取权限；等确认策略后再补开合约权限，系统会自动提示权限不足。
开卡自检清单
逐项确认后再去绑定。勾选状态保存在本机浏览器，刷新不会丢失。
0%
0 / 7 项已完成
常见报错排查
绑定后在「我的交易 → 账户 → 诊断」会返回交易所原始错误码，对照下表定位。
| 错误码 / 提示 | 含义 | 处理方式 |
|---|---|---|
-2015 Invalid API-key, IP, or permissions | Key、IP 或权限三者之一不匹配 | 核对 Key 是否含空格；确认 IP 白名单为当前机器出口 IP；确认已勾选合约权限 |
-1022 Signature for this request is not valid | 签名错误 | Secret 填错或复制不全；系统时间偏差过大也会触发，校准服务器时间 |
-2014 API-key format invalid | Key 格式非法 | 粘贴时带了引号 / 空格 / 换行，重新复制 |
50111 Invalid API key（OKX） | Key / Secret / Passphrase 三件套不匹配 | Passphrase 是创建时自己设置的，不是登录密码；忘记只能重建 |
50113 Invalid Sign（OKX） | 签名失败 | 检查 Secret 与 Passphrase 是否对应同一把 Key |
10001 accountType only support UNIFIED（Bybit） | 账户不是统一账户 | 在 Bybit 将账户切换为「统一交易账户 UNIFIED」后重新诊断 |
INVALID_SIGNATURE（Gate） | 签名错误 | Secret 与 Key 不匹配，重建后重新绑定 |
| 余额为 0 / 可用保证金不足 | 资金在现货账户 | 在交易所把 USDT 划转到合约账户（这一步在交易所 App 内完成，不需要给 Key 划转权限） |
绑定到系统
STEP 01
打开「我的交易」
左侧导航 → 我的交易 → API 账号
›STEP 02
新增 API 账号
选择交易所，粘贴 Key / Secret（OKX 另需 Passphrase）
›STEP 03
点「诊断」
系统会读取余额与持仓，验证权限是否就绪
›STEP 04
创建跟单规则
选择信号源、倍率与本金，开始等比跟随
i
密钥在数据库中以掩码形式回传前端（只显示首尾若干位），页面不会回显完整 Secret。建议一个系统一把专用 Key，便于单独吊销与轮换。
常见问题
一定要开提现权限吗？
不需要，也永远不要开。系统的所有下单都走合约交易接口，提现权限对它没有任何用处。
Secret 忘了 / 丢了怎么办？
交易所不会再次显示 Secret，只能在 API 管理中删除旧 Key 并新建一把，然后回到系统重新绑定。删除 Key 不会平掉已有仓位，也不会影响历史订单。
可以用主账户的 Key 吗？
可以，但更推荐用子账户：单独入金、单独风控，主账户资金与主账户 Key 完全隔离。子账户同样支持合约与 API。
IP 白名单可以留空吗？
技术上可以，但等于放弃最后一道防线。若部署在固定公网 IP 的服务器上，强烈建议填写；家庭宽带 IP 会变化，可先留空并在路由器上做好安全加固，或使用固定出口的云主机。
为什么只读权限也能看到盈亏？
持仓、余额、成交记录都属于读取范围。系统的「今日盈亏」按交易所成交汇总计算，不需要任何写权限。
模拟盘 / 测试网怎么配？
测试网需要单独申请测试 API Key，且与实盘域名不同。当前系统的个人交易模块面向实盘；若只想验证信号，可先用只读 Key + 手动同步。
多久轮换一次密钥？
建议每 90 天轮换一次，或在人员变动、设备丢失、疑似泄露时立即轮换。轮换时先建新 Key 绑定，确认诊断通过后再删除旧 Key，避免监控中断。
密钥准备好了？
去「我的交易」绑定账户，创建第一条等比跟单规则。