只读、交易、提现:交易所 API Key 的三个开关别一起打开

交易所 API 出事,很少是被”攻破”,多数是权限给多了。一把为了跑网格策略创建的 key,顺手开了提现权限、没绑 IP、写在共享脚本里——这不是安全漏洞,这是主动把钥匙放在门口。这篇把三个权限位、签名机制和处置顺序拆开讲。

三个权限位决定一把 key 的边界

权限位 能做什么 泄露后果 建议
读取 查余额、订单、成交历史 资产规模与策略暴露 可开,配合 IP 白名单
交易 下单、撤单、开平仓 被反向开仓、刷手续费 只在需要时开
提现 转出到外部地址 直接资金损失 默认关闭

主流交易所(币安、OKX、Bybit)都把提现权限与 IP 白名单绑定:开启提现必须填入固定 IP,之后从其他 IP 调用会被拒绝。这条规则是整条链上唯一”事后无法绕过”的限制。

签名证明的是”你有 secret”

REST 请求的签名通常是:sign = HMAC_SHA256(secret, timestamp + method + requestPath + body)。服务端用同一份 secret 重算,一致才放行。secret 只参与本地计算,永远不该出现在请求体里。

两个细节值得注意:一是时间戳窗口(币安的 recvWindow 默认 5000 毫秒),服务器时间偏差过大会直接报错,很多人误以为是 key 失效;二是 OKX 一类的平台还需要第三个凭据 passphrase,三件套分别泄露任何一件都不足以签名,但一起泄露就等于账户失控。

IP 白名单是最后一道闸

白名单有效的前提是出口 IP 固定。把脚本跑在家宽带上,运营商重新拨号就换 IP;跑在云函数或容器里,出口 IP 更是随机。所以上白名单之前先确认出口 IP,否则你会得到一堆”签名正确但被拒绝”的报错。

四种常见误配

  • 把 key 写进前端 JavaScript,浏览器一开控制台就能看到;
  • 用主账号 key 接第三方跟单或量化平台,等于把账户交给对方;
  • 为了”自动搬砖”打开提现权限,搬砖本身不需要提现;
  • 所有策略共用一把 key,出事时无法定位是哪套程序泄露。

泄露之后的处置顺序

  • 先删 key(不是改权限,是删除),切断所有调用;
  • 撤掉未成交挂单,尤其是条件单与止损单;
  • 改登录密码、重置 2FA,检查绑定邮箱与手机号;
  • 核对提现地址簿有没有被新增陌生地址;
  • 联系客服冻结提现,并保留调用日志作为凭证。

合约权限的额外风险

开了合约交易权限,等于把爆仓风险交给持有 key 的人。合约是保证金交易,方向做反时亏损会超过初始投入并触发强制平仓,本金可能归零;这不是浮亏,是不可逆的结算。所以给策略开合约权限时,应使用子账户并只转入该策略愿意承担的资金。

FAQ

问:只读权限泄露了危险吗?
答:不会直接损失资金,但会暴露持仓规模、策略频率与账户 ID,足以被针对性钓鱼,仍应绑定 IP 并定期轮换。

问:开了 IP 白名单还需要限权限吗?
答:需要。白名单防的是异地调用,防不了同 IP 下的脚本被盗或被第三方平台滥用。

问:key 能不能设置有效期?
答:部分平台支持到期自动失效或按需删除,建议为一次性任务创建临时 key,用完即删。

来源:币安 API 文档 API Key 权限与 IP 访问限制章节(developers.binance.com,访问 2026-10-23);OKX API 文档 API Key 创建与 Passphrase 说明(okx.com/docs,访问 2026-10-23);Bybit API 文档权限管理章节(bybit-exchange.github.io/docs,访问 2026-10-23)。

内链:一次 approve 就等于交出全部余额吗 / 玩家安全中心:10 项自检 / 多签的阈值不是越多越安全

安装 App