币安 API key 安全:最小权限、IP 白名单、被盗怎么办
只要你用过跟单、量化、自动记账、行情面板这类工具,多半就给币安创建过 API key。它很方便——让程序替你读数据、甚至替你下单。但方便的另一面是:这把钥匙一旦权限给大了、又被泄露,程序能做的事,别人也能替你做,包括下单、调仓,配置不当时甚至提币。这篇把 API 安全讲清楚:它是什么、权限该怎么收、IP 白名单怎么用、多久该换一次,以及万一怀疑泄露了,怎么撤销重建止损。
API key 是什么、风险在哪
API key 可以理解成一把给程序用的钥匙。你在币安创建它时,会拿到一对东西:一个API Key(公开标识,相当于钥匙的编号)和一个Secret Key(密钥,相当于钥匙本身)。你把它们填进某个工具,这个工具就能代表你跟币安通信,按你给的权限范围做事——读行情、查余额、下单等等。
风险点不在"用 API"本身,而在三件事叠加:
- 权限给大了:一个只需要看行情的记账工具,你却给了它交易、甚至提币权限。
- 密钥泄露了:Secret Key 落到别人手里——可能是工具方被攻破、你把它贴错地方、设备中毒被读走。
- 没绑 IP:这把 key 在任何网络位置都能用,泄露后对方随时随地能拿它发请求。
三件事凑齐,别人就能拿你的 key 替你操作。所以 API 安全的核心思路就一句:把每一把 key 的能力和使用范围,压到刚好够用、不多一分。下面几节就是这句话的拆解。想先快速体检一下你现有的 key 配得对不对,可以用API 权限风险自查勾一勾。
最小权限:能不给就不给
这是 API 安全里最该先记住的一条。创建 key 时,币安让你勾选这把 key 拥有哪些权限,常见的有读取(看行情、查账户)、交易(下单)、以及更敏感的提币等。原则只有一个:这个工具用得上哪些,才勾哪些。
- 只看行情、做记账、看持仓——只给读取权限就够,别开交易、绝不开提币。
- 要自动交易(量化、跟单)——给交易权限,但提币权限能不开就不开。大多数交易策略并不需要把币提出去。
- 提币权限——这是 API 里最危险的一档,等于把"把币转走"的能力交给程序。除非你非常清楚自己在做什么、且工具完全可信,否则默认就该是关闭的。
这样做的好处很直接:万一这把 key 泄露了,对方能造成的损失被权限框死了。一把只读的 key 泄露,对方顶多看看你的余额,转不走一分钱。这就是"最小权限"的全部意义——把泄露的后果提前限定住。
绑 IP 白名单
如果说最小权限管的是"这把 key 能做什么",那 IP 白名单管的是"这把 key 能在哪用"。绑定之后,这把 key 只有从你指定的 IP 地址发请求才有效,其它任何位置发来的请求一律被拒。
它的价值在于:就算 Secret Key 泄露了,对方在他自己的网络位置上也用不了这把 key——因为他的 IP 不在白名单里。这相当于给钥匙又加了一道"只在这个门口才好使"的限制,是 API 防护里非常硬的一道。
用好它的要点:
- 有固定 IP 的尽量绑:如果你的工具跑在固定 IP 的服务器上(很多量化、跟单部署在云服务器),把那个 IP 加进白名单,性价比极高。
- 家用宽带 IP 多是动态的:会变的 IP 绑了之后过几天可能就连不上,要权衡。但即便如此,IP 受限的 key 仍比完全不限的安全得多。
- 注意币安对某些权限的要求:部分敏感权限(如提币)通常要求必须绑 IP 才能开启——这本身就是币安在提醒你这类权限有多敏感。具体规则以币安创建 API 页面当前显示为准。
密钥怎么保管
权限和 IP 都是"万一泄露的兜底",而不泄露本身才是第一道。Secret Key 的保管,记住几条:
- Secret Key 通常只在创建时显示一次。当场复制保存好,别指望以后还能再看到。存的地方要安全——别贴在聊天记录、便签、截图、公开的代码仓库里。
- 别把 key 硬写进会被别人看到的地方。最典型的事故是把含密钥的代码传到了公开仓库,被自动扫描程序秒抓走。
- 填进工具前,先确认工具本身可信。你把 key 交给一个工具,等于信任它会妥善保管——下一节细说。
- 怀疑某台设备中毒,就把它上面用过的 key 都当作可能已泄露处理,撤了重建。
定期轮换与清理
API key 不是"建一次用到底"的东西。两个习惯能把长期风险压下来:
- 定期轮换:隔一段时间换一把新 key、删掉旧的。key 存在越久、用过的地方越多,悄悄泄露的概率越高。重要的、权限较大的 key 尤其值得定期换。
- 用完即清:那些你只是一时尝试、早就不用的工具留下的 key,回去把它删掉。每多留一把不用的 key,就多一个你没在盯着的风险口子。
建议你现在就去币安的 API 管理页面,把列出来的 key 从头看一遍:每一把还在用吗?权限是不是过头了?绑 IP 了吗?拿不准就用API 权限风险自查逐项对一下。不用的删,权限大的收紧——这趟清理花不了十分钟。
第三方工具的风险
你把 API key 填进一个第三方工具,本质是把对账户的部分操作权,托付给了这个工具和它背后的人。所以 key 安全里很大一块,其实取决于工具本身靠不靠谱:
- 工具方被攻破,你的 key 跟着遭殃。哪怕你保管得再好,存了你密钥的那一方若被入侵,key 也可能外泄。所以宁可用口碑可查、长期运营的工具。
- 警惕索要过多权限的工具。一个只该读数据的工具却要交易甚至提币权限,这本身就是危险信号。能用只读 key 解决的,就别给它更高权限。
- 警惕要你"贴 Secret Key 到某处"的钓鱼套路。有些假工具、假"客服"会诱导你交出密钥。记住正规流程里,你是把 key 填进工具的配置,没有任何人需要你私下把 Secret Key 发给他。
- 给每个工具单独建 key。别一把 key 喂给好几个工具——这样哪个工具出事,你只撤那一把,不影响其它,排查也清楚。
怀疑泄露:撤销与重建
一旦怀疑某把 key 泄露了——比如账户出现你没下过的订单、用过 key 的设备可能中毒、工具方爆出安全事件——别犹豫,按这个顺序处理:
- 立刻删除(撤销)这把 key。在币安 API 管理里把它删掉,让它彻底失效。注意是删除,不是只改权限——只要旧密钥还存在,就还有被用的可能。
- 检查账户近期活动:看订单记录、资产变动、登录设备有没有异常。如果发现陌生操作,说明问题可能不止 API,要按账户被盗自救的流程整体处置——改登录密码、查 2FA、必要时紧急冻结。
- 排查泄露源头:是哪台设备、哪个工具出的问题?源头不堵住,重建一把新 key 也可能再次泄露。
- 为还要用的工具重建一把更收紧的新 key:权限砍到最小、绑好 IP,把这次的教训配进去。
API 被盗往往和账户整体安全连在一起,别只盯着 key。怀疑账户层面也出了问题时,整套应急动作见被盗自救完全指南,也可以跟着API 权限风险自查先把现有 key 的风险点列清楚。
常见问题
币安 API key 会被用来提币吗?
只有在你给这把 key 开了提币权限、没绑 IP、密钥又泄露时才可能。提币是 API 里最危险的一档,多数用途(看行情、记账、跟单)都用不上。原则是不需要就别勾提币权限,这样即使 key 泄露对方也提不走币。
绑了 IP 白名单还有必要保密 API key 吗?
有。IP 白名单把 key 限定在固定 IP 才能用,很强,但不能替代保密。万一对方从被允许的网络发起请求、或你日后改了 IP 设置,密钥的保密仍是底线。两道一起上:最小权限 + 绑 IP + 严格保密。
怀疑 API key 泄露了第一步做什么?
第一步立刻在币安删除(撤销)这把 key 让它失效,而不是只改权限。然后检查近期订单、资产、登录有无异常,确认账户整体安全,再为继续要用的工具重建一把权限收紧、绑好 IP 的新 key。
一把 key 给多个工具用可以吗?
不建议。给每个工具单独建 key,哪个工具出事只撤那一把,不牵连其它,排查也清楚。一把 key 喂多个工具,一处泄露就是全部暴露。
API 的权限选项和 IP 规则会变吗?
会。币安的权限分类、对敏感权限是否强制绑 IP 等规则可能调整。本文讲的是原则,具体选项与要求以币安创建/管理 API 页面当前显示为准。
参考来源
- 币安官方帮助中心 · API 管理与安全相关条目(binance.com/zh-CN/support,以官方当前页面为准)
- 币安安全页 · 账户安全功能说明(binance.com/zh-CN/security)