币安 API 权限与 IP 限制:系统生成的 key 不绑 IP 只能读取,泄露怎么办
在币安建 API key,权限勾哪几项、IP 限制填不填,界面上是两个设置,规则上却绑在一起:不加 IP 限制,系统生成的 key 只能开读取;要开提币,必须先加 IPv4 格式的 IP 限制。前一条从 2023 年 1 月 30 日 00:00(UTC)起生效;两条都写在币安帮助中心现行说明里(2026 年 11 月查证)。想让工具替你下单、又不想绑 IP,官方给的路只有三条:加 IP 限制,改用自己生成的 Ed25519 / RSA key,或者关掉默认安全控制。下面先把这两样分开,讲清各拦得住什么、拦不住什么,再给 -2015 报错的排查顺序和泄露后的处理。
一把 key 里的两样东西
API key 是给程序用的钥匙。币安有两种:系统生成的 key 用 HMAC 对称加密,建好后给你两段字符——API Key 和 Secret Key;自行生成的 key 用 Ed25519 或 RSA 非对称加密,你先用第三方软件在本地生成一对公钥和私钥,只把公钥交给币安。哪一种填进工具,工具都能代表你跟币安通信,能做多少由这把 key 的设置决定。
设置里真正决定泄露后果的是两样,常被当成一回事:
- 权限开关,管「能做什么」:读取、交易、提币、划转……勾了哪项,拿到 key 的程序就能做哪项。
- IP 限制,管「在哪能用」:填了 IPv4 地址,只有从这些地址发来的请求才被接受。
两样拦的东西不同。权限开关不管谁在用,只限定用的人能干什么。IP 限制挡不住从白名单地址发来的请求——跑工具的服务器一旦被攻破,对方本来就站在白名单里。key 出事,通常是权限开得过宽,密钥又落到了别人手里。想先对照手上现有的 key,可以用API 权限风险自查勾一遍。
权限开关:这把 key 能做什么
币安开发者文档里「查询 API Key 权限」接口列出的开关,对到创建页上是这几项:读取、现货与杠杆交易、提币、主账户与子账户之间的内部划转、万向划转、合约、期权;另有统一账户和 FIX 接口相关的几项,普通工具用不到。原则一条:工具用得上哪项,才勾哪项。
- 只看行情、记账、看持仓:只开读取。不加 IP 限制的系统生成 key,本来也只能开到这一步。
- 自动交易(量化、跟单):按策略交易的品种开现货与杠杆交易或合约,提币不开。交易策略用不着把币提走。
- 合约:key 建在你开通合约账户之前,或者账户开了统一账户(Portfolio Margin),官方说明这把 key 开不了合约权限,要用得另建一把。
- 提币:唯一能把币送出你账户的开关。开之前必须先加 IPv4 限制,这是硬性要求。
两项划转最容易被顺手勾上。内部划转能在主账户和子账户之间即时转资金,万向划转授权这把 key 调用专门的划转接口、可划转多种支持的币种。它们也能动钱。内部划转挪的是你主账户和子账户之间的钱,币出不了你的名下,但你给各个子账户分好的资金会被打乱;万向划转能把币划到哪,以接口文档为准。用不上就一样别开。
最小权限的好处,要到泄露之后才看得出来:一把只读的 key 落到别人手里,对方能看到余额和订单,动不了一分钱。
IP 限制:这把 key 在哪能用
填上 IP 限制,这把 key 只接受从你列出的 IPv4 地址发来的请求,别处来的一律拒绝。Secret Key 就算泄露,对方在自己的网络上也用不了。
它和权限开关怎么绑在一起,币安帮助中心写得很直接:
- 提币:「要启用提现权限,必须添加 IP 访问(IPv4 格式)限制。」
- 其他权限:「无 IP 访问限制的 HMAC API 密钥除读取权限之外没有任何权限。」英文版同一篇还写明了生效时间:2023 年 1 月 30 日 00:00(UTC)起,不限 IP 的系统生成 key 只能设为读取。
| key 类型 | 读取 | 交易等其他权限 | 提币 |
|---|---|---|---|
| 系统生成(HMAC),不加 IP 限制 | 可以 | 不能 | 不能 |
| 系统生成(HMAC),加了 IPv4 限制 | 可以 | 可以 | 可以开 |
| 自行生成(Ed25519 / RSA) | 可以 | 可以,官方列为不绑 IP 时的出路之一 | 仍必须加 IPv4 限制 |
表中说法出自币安帮助中心创建 API 密钥的说明(文章编号 360002502072),2026 年 11 月查证,以页面实时显示为准。中文帮助中心对 2023-01-30 那条规则的译法有歧义,本文按英文版原意写。单项权限能不能开,还受账户状态影响,比如上一节说的合约。
官方列的第三条出路是「禁用默认安全控制措施」。它做的就是把这道保护拿掉,让不限 IP 的 key 也能开别的权限。本站不建议走这条:key 一旦泄露,对方在哪都能拿它下单。
家里的 IP 会变,怎么选
家用宽带的公网 IP 多半会变。绑了它,哪天地址一换,工具就连不上;不绑,系统生成的 key 只剩读取。要跑自动交易,稳一点的做法有两种:
- 把工具放到有固定 IP 的服务器上,绑那个 IP。
- 改用自行生成的 Ed25519 key,不绑 IP 也能开交易。
第二种要多想一步。下面是我们的推断,不是官方说法:自生成 key 不绑 IP 时,挡在你和攻击者之间的就只剩那把私钥,私钥文件放在哪台电脑、谁碰得到,成了唯一的防线。我们的取舍是能上固定 IP 就上固定 IP,自生成 key 留给实在没有固定地址的场景。
搜这个问题还常看到「不绑 IP 的 key 90 天后会被停用」。币安现行帮助中心这篇说明里没有这一条,查询 key 权限的接口也没有到期时间字段,本文不按它写。
密钥怎么保管
权限和 IP 都是泄露之后的兜底,不泄露才是第一道。
- 系统生成的 key 建好后给你 API Key 和 Secret Key 两段。Secret Key 通常只在创建时显示,官方帮助中心没写这一句,按只能看一次来准备:当场存进密码管理器这类地方,别留在聊天记录、便签和截图里。
- 自行生成的 key,私钥一直在你自己手里,币安那边只有公钥。私钥文件被人拷走,等于钥匙本身被拿走。
- 别把 key 写进代码再推到公开仓库。这是最常见的泄露方式之一,公开仓库一直有自动程序在扫。
- 怀疑某台设备中毒,就把在它上面用过的 key 都当成已经泄露,删了重建。
定期轮换与清理
key 不是建一次用到底的东西。
- 定期换:隔一段时间新建一把、删掉旧的。存在越久、填过的地方越多,悄悄泄露的机会越大;权限大的那几把尤其值得先换。
- 用完即删:试过一次就再没打开的工具,它手里还握着你的 key,回去删掉。
现在就可以打开币安的 API 管理页,从上往下看一遍:每把还在用吗?权限是不是开过头了?IP 限制填了吗?拿不准的用API 权限风险自查对一下。
第三方工具的风险
把 key 填进第三方工具,等于把账户的一部分操作权交给这个工具和它背后的人。IP 限制在这里帮得没想象中多:工具跑在它自己的服务器上,你绑的正是那台服务器的 IP,服务器被攻破,对方就在白名单里面。
- 用口碑可查、长期运营的工具。工具方公布过安全事件,就把填给它的 key 删掉重建。
- 只该读数据的工具却要交易甚至提币权限,这本身就是危险信号。
- 有人让你把 Secret Key 私下发给他,不管自称工具客服还是币安客服,都是骗局。正常流程只有你自己把 key 填进工具的设置页。
- 每个工具单独建一把 key。哪个出事只删哪把,排查也清楚。
报 -2015 是哪一样出了问题
工具日志里出现 -2015,原文是 Invalid API-key, IP, or permissions for action.(币安现货 API 官方错误码文档,代码名 REJECTED_MBX_KEY)。一句话里塞了三种原因,按这个顺序排:
- key 本身:API Key 是不是抄错了、多带了空格,或者这把 key 已经在币安删掉了。
- IP:工具实际发请求的出口 IP 在不在你填的白名单里。工具换了服务器、家里宽带重新拨号,都会让地址变掉。
- 权限:这个动作需要的权限开了没有。最典型的是合约:key 建在开通合约账户之前,合约权限开不了,只能新建一把。
有些论坛帖和工具帮助页会建议「先把 IP 改成不限制试试」。别这样修。系统生成的 key 改成不限 IP,按现行规则只剩读取,交易照样做不了;要是为此再去关默认安全控制,等于把保护整个拿掉。找到是哪一样,就只修那一样。
怀疑泄露:撤销与重建
账户里出现你没下过的订单、用过 key 的设备可能中毒、工具方公布安全事件——碰上任何一样,按这个顺序处理:
- 立刻删除(撤销)这把 key。在币安 API 管理里删掉,让它彻底失效。是删除,不是只改权限或 IP——旧密钥还在,就还有被用的可能。
- 检查账户近期活动:订单记录、资产变动、登录设备有没有异常。发现陌生操作,说明问题可能不止 API,要按账户被盗自救的流程整体处置:改登录密码、查 2FA、必要时紧急冻结。
- 排查泄露源头:是哪台设备、哪个工具出的问题?源头不堵,新 key 也会照样漏出去。
- 为还要用的工具重建一把更紧的新 key:只勾它用得上的权限,IP 限制绑在你掌控的服务器上。
API 出事往往和账户整体安全连在一起,别只盯着 key。怀疑账户层面也有问题时,整套应急动作见被盗自救完全指南;手上剩下的 key,可以跟着API 权限风险自查把风险点先列清楚。
安全上的追问
币安 API key 会被用来提币吗?
要三件事同时成立:这把 key 开了提币;请求来自它 IP 白名单里的地址;密钥泄露了——比如跑工具的那台服务器本身被攻破。提币必须先加 IPv4 限制才能开,「开了提币、没绑 IP」的 key 按现行规则建不出来。没有提币需求就别开;真要开,只绑你自己掌控的那台服务器。
绑了 IP 白名单还有必要保密 API key 吗?
有。对方要是从被允许的地址发请求(比如攻破了那台服务器),IP 限制拦不住;你日后改 IP 设置,也可能留下缺口。最小权限、IP 限制、密钥保密,三样一起上。
怀疑 API key 泄露了第一步做什么?
第一步立刻在币安删除(撤销)这把 key 让它失效,而不是只改权限。然后检查近期订单、资产、登录有无异常,确认账户整体安全,再为继续要用的工具重建一把权限收紧、绑好 IP 的新 key。
一把 key 给多个工具用可以吗?
不建议。给每个工具单独建 key,哪个工具出事只撤那一把,不牵连其它,排查也清楚。一把 key 喂多个工具,一处泄露就是全部暴露。
API 的权限选项和 IP 规则会变吗?
会,而且已经变过一次大的:2023 年 1 月 30 日 00:00(UTC)起,系统生成的 key 不限 IP 时只能设为读取。另外,开提币必须加 IPv4 限制,官方这条没标生效日期。2026 年 11 月查证时,这两条仍写在币安帮助中心里。以后再调整,以币安创建 / 管理 API 页面和帮助中心当时显示为准。
不绑 IP 的 key 会在 90 天后被删掉吗?
不少教程这么写。币安现行帮助中心关于创建 API 密钥的说明里没有这一条,本文不把它当规则。你的 key 还在不在、是什么状态,以 API 管理页显示为准。
参考来源
- 币安帮助中心 · 创建 API 密钥(文章编号 360002502072):中文版(页面标最后更新 2025-03-20)、英文版(页面标更新于 2026-11-06),均于 2026-11-13 核对
- 币安现货 API 错误码文档 · -2015 REJECTED_MBX_KEY(GitHub binance-spot-api-docs)
- 币安开发者文档 · Get API Key Permission(GET /sapi/v1/account/apiRestrictions)各权限字段说明