很多人建 API key 的时候只看一个勾选框:「只读」,然后放心地把 key 贴进第三方工具。问题在于,「只读」是一个模糊的词——它能读到的内容,往往包括你的持仓、订单历史、子账户结构、以及资金划转记录。这些信息本身不产生亏损,但它是所有社工与跟单攻击的原料。这篇把四种权限的实际杀伤力列清楚,再给一份六项核对清单。
一、四种权限,四种后果
| 权限 | 能做什么 | 泄露后的直接后果 | 风险等级 |
|---|---|---|---|
| 读取(Read) | 查余额、持仓、订单、成交、划转记录 | 策略与仓位被看见;地址与身份被关联 | 中(间接) |
| 现货交易(Spot Trade) | 下单、撤单 | 被反向操作、被刷手续费、被当对手盘 | 高 |
| 合约交易(Futures Trade) | 开平仓、调杠杆、改保证金模式 | 被开高杠杆仓位后在极端行情被强平 | 极高 |
| 提币(Withdraw) | 把资产转到白名单地址 | 资产直接离开账户 | 最高 |
关键认知:多数交易所在 API 管理中把「提币」权限单独列出,且默认不启用;但「合约交易」权限一旦开启,攻击者不需要提币也能让你的账户归零——他只需要在你的账户里开一个高杠杆仓位,然后等一次正常波动。这就是「不提币也能亏光」的路径。
二、只读 key 的三种间接损失
只读权限不直接动钱,但它能造成三类损失,而且都不容易归因:
- 策略被复制或反制。持仓与订单流的实时数据足以让对手推断你的挂单习惯、止损位置与仓位上限。你以为自己在打暗牌,实际上桌面上摊着。
- 成为社工的精准目标。知道你有多少资产、用什么子账户结构、最近有没有大额划转,就能编出可信度极高的「客服」话术。冒充平台诈骗的第一步,往往就是从一份只读权限的数据开始的。
- 地址与身份被关联。提币记录里包含收款地址,多个地址一旦被聚到同一个账户名下,链上隐私就没了,后续的针对性攻击也就有了入口。
三、三条最小化规则
- 按用途建 key,不按方便建 key。一个策略一个 key,一个 key 只开一种权限。用完即删,不要留「以后可能用得上」的常驻 key。
- 能绑 IP 就绑 IP。把 key 限制在固定出口 IP 上,泄露后的可用窗口会被大幅压缩——攻击者得先拿到那个 IP 才行。
- 提币权限永远不开给程序。需要提币就走手动流程,或者用独立的、不接入任何第三方工具的子账户。交易权限与提币权限分离,是唯一能限制「一次泄露即全部损失」的结构。
四、六项核对清单
| # | 核对项 | 在哪里看 | 不通过的处置 |
|---|---|---|---|
| 1 | 这个 key 是否开启了提币权限 | API 管理页的权限勾选 | 立即关闭;若无法关闭,直接删除 key |
| 2 | 是否绑定了 IP 白名单 | 同一页面的 IP 限制设置 | 补绑出口 IP |
| 3 | 是否开启了合约交易权限 | 权限勾选 | 没有合约策略就关掉 |
| 4 | 这个 key 被哪些第三方工具使用 | 自己的工具清单 + key 备注 | 清掉不用的,重命名便于追溯 |
| 5 | 最近调用记录是否异常 | API 管理页的调用日志 | 有陌生来源立刻删除并轮换 |
| 6 | key 是否曾出现在聊天、截图、代码仓库里 | 自己排查 | 一律视为已泄露,立即轮换 |
第 6 项最容易被放过。把 key 贴在聊天里让朋友「帮忙看一下」,或者提交到公开仓库后再删掉,都不算安全——交易所的密钥没有「撤销历史」这种东西,只能删了重建。
五、泄露之后的三步
- 先删 key,再查损失。顺序不能反。删除是唯一能立刻切断攻击路径的动作。
- 看两样东西:未平仓位与挂单、以及提币白名单有没有被改。白名单的修改或有冷却期(24 小时量级),发现被改就要立刻联系平台冻结。
- 改密码与二次验证,并检查子账户。主账户的 key 泄露往往伴随其他入口被打开,尤其是同一邮箱注册的关联账户。
至于「我怎么知道 key 泄露了」——多数情况下你不会知道,直到仓位被动过。所以正确的做法不是检测,而是让泄露的后果有上限:权限最小化、IP 绑定、提币分离。任何 API 权限配置都无法消除交易本身的市场风险,合约仓位在极端行情下仍可能被强制平仓。
FAQ
问:只读 API key 泄露了,需要立刻删除吗?
需要。只读权限能看到持仓、订单历史与划转记录,这些数据足以支撑针对性的社工与反向交易。虽然不直接动钱,但它是后续攻击的入口,应当立即轮换。
问:绑了 IP 白名单就安全了吗?
不是。IP 白名单只降低了「异地直接调用」这一种路径,如果攻击者在你同一网络环境内,或者在能访问该 IP 的机器上,白名单不起作用。它是一层减速带,不是保险箱。
问:为什么不能给程序开提币权限?
因为提币是把资产移出平台,没有第二道市场缓冲。一旦 key 泄露,损失是立即且彻底的。把提币保留为手动动作,等于给账户加了一道人工确认。
相关阅读
- 429 不是封号:交易所 API 的权重预算与退避清单
- 签名没错却返回 timestamp 错误:recvWindow 里被吃掉的三种时间
- 转账记录里那个只差两头的地址:地址投毒是怎么发生的,四步核对让它失效
本文只讨论 API 密钥的权限结构与核对方法,不构成投资建议,不推荐任何交易所,也不给出买卖点位。权限配置无法消除市场风险:合约仓位在极端行情下会被强制平仓,可能损失全部保证金;具体权限项与命名请以你所使用平台的当前文档为准。
来源与访问日期
1. 主流交易所公开的 API 文档中关于密钥权限分类(读取、现货交易、合约交易、提币)与 IP 白名单的说明。访问日期 2026-10-29。
2. 交易所 API 安全最佳实践文档中关于「不要将密钥写入代码仓库」「定期轮换密钥」的表述。访问日期 2026-10-29。
3. 本站旧文《429 不是封号:交易所 API 的权重预算与退避清单》《recvWindow 里被吃掉的三种时间》,用于交叉核对接口层的调用约束。访问日期 2026-10-29。
2. 交易所 API 安全最佳实践文档中关于「不要将密钥写入代码仓库」「定期轮换密钥」的表述。访问日期 2026-10-29。
3. 本站旧文《429 不是封号:交易所 API 的权重预算与退避清单》《recvWindow 里被吃掉的三种时间》,用于交叉核对接口层的调用约束。访问日期 2026-10-29。