币安API key泄露了会被偷币吗
量化交易者、网格机器人用户、跨交易所搬砖玩家,都离不开API key。但API key一旦泄露,会发生什么?先给个结论:如果你只开了"读取"权限且绑定了IP白名单,泄露风险几乎为零;如果开了"提币"权限且没绑IP,资金可能在几分钟内被全部转走。差别在于你怎么配置权限。本文把API key的权限分级、正确配置、IP白名单、定期轮换、泄露后的止损全部讲清。在配置API之前,先通过 币安官网 登录,网页端配置API最直观;日常管理也可以用 币安官方APP;iPhone用户找不到App的看 iOS安装教程 先装好。
API key到底是什么
API(Application Programming Interface)是交易所给程序开的接口,每个API key由两部分组成:
- API Key:公开部分,相当于账号;
- Secret Key:私密部分,相当于密码,只在创建时显示一次。
第三方程序(网格机器人、量化策略、数据采集器)拿着这对密钥就可以代表你的账户做操作,无需网页登录。
API key的危险性在于:它可以绕过2FA。创建时走了一次2FA验证,之后程序每次调用不再需要验证。这也是为什么权限配置比配置一个2FA还要谨慎。
币安API的权限分级
币安把API权限拆成了若干档位,按风险从低到高排。
| 权限 | 能做什么 | 默认状态 | 泄露风险 |
|---|---|---|---|
| 读取 | 查询余额、订单、K线 | 默认开启 | 低 |
| 现货交易 | 下单买卖 | 需启用 | 中 |
| 杠杆交易 | 杠杆借贷买卖 | 需启用 | 中高 |
| 合约交易 | 开合约仓位 | 需启用 | 中高 |
| 划转 | 账户间资金划转 | 需启用 | 高 |
| 提币 | 提币到链上地址 | 需启用 | 极高 |
| 内部转账 | 给币安用户转账 | 需启用 | 极高 |
黄金规则:永远只开业务必需的权限,一颗不多。量化策略一般只需要"读取+现货交易",不需要开提币。
最严格的API配置模板
这是推荐配置,几乎适用所有场景。
场景1:只看盘不下单的数据采集
- 读取:开
- 其他:全关
- IP白名单:开(绑你的服务器IP)
- 有效期:180天后自动过期
场景2:网格机器人/量化交易
- 读取:开
- 现货交易:开
- 合约交易:按需
- 划转:关(最关键)
- 提币:绝对关
- IP白名单:开(绑机器人服务器IP)
- 有效期:30-90天
场景3:跨交易所搬砖(必须要划转提币的)
- 读取:开
- 现货交易:开
- 提币:开(仅限白名单地址)
- 提币白名单:只加目标交易所的充币地址
- IP白名单:开
- 有效期:7-30天
场景4:查账统计
- 读取:开
- 其他:全关
- IP白名单:开
- 有效期:30天
IP白名单是API的第二道锁
IP白名单和API权限是乘法关系:没开IP白名单,就算只开了读取权限也可能被滥用(查你的持仓隐私)。
怎么绑定IP白名单
- 登录币安 → 账户 → API管理;
- 找到对应的API key,点「编辑」;
- 「IP访问限制」选「仅信任的IP访问」;
- 输入你的服务器公网IP(可以输多个,用英文逗号分隔);
- 提交。
怎么查自己的公网IP
- 服务器上执行
curl ifconfig.me或curl ip.sb; - 本地浏览器访问 ip.sb 即可看到。
如果IP是动态的怎么办
- 家宽通常是动态公网IP,每天可能变化;
- 解决:①租个固定IP的VPS跑机器人;②用DDNS+币安API定期更新白名单;③改用云服务商固定出口IP。
没开IP白名单的API key,泄露后等于裸奔。
API key的常见泄露场景
很多人不知道自己的API怎么泄露的,典型泄露路径如下。
场景A:代码提交到GitHub
最常见。把API_KEY和SECRET硬编码在Python脚本里,然后push到公开仓库。GitHub有机器人全天扫描,泄露后几分钟就会被利用。
防范:用环境变量或.env文件存密钥,.gitignore里加上*.env。
场景B:粘贴到第三方工具
不知名的量化平台、交易信号服务要你提交API key做"监控",这种平台大概率会保留密钥。
防范:只用币安官方列出的认证合作伙伴,或知名老牌平台(3Commas、CoinGlass等)。
场景C:电脑中了木马
木马会监控剪贴板和常见配置文件,读取本地密钥。
防范:机器人专用机只运行机器人,不上网、不看视频;运行常见杀毒软件;API定期轮换。
场景D:员工离职带走密钥
团队共用一个API key,员工离职后忘记重置。
防范:每人一把key,离职立刻作废;重要操作走白名单地址。
场景E:云服务器被入侵
服务器弱密码、SSH暴露到公网导致被爆破。
防范:SSH改端口+禁用密码登录+只允许密钥登录;防火墙只开必要端口;定期更新系统补丁。
API key的定期轮换策略
即便现在没泄露,时间久了概率就高。建议按周期轮换。
轮换周期
- 高频交易:每30天;
- 中频:每60-90天;
- 低频数据查询:每180天;
- 一次性调试用:用完立刻删。
轮换步骤
- 创建一个新的API key;
- 更新机器人或脚本里的配置;
- 测试新key能正常工作;
- 在币安后台删除旧的API key;
- 记录本次轮换时间。
如果API key已经泄露了怎么办
按下面这个checklist操作,越快越好。
紧急处置(5分钟内)
- 登录币安 → API管理 → 立刻删除泄露的API;
- 检查账户持仓是否有异常变动;
- 查看资金流水看有没有异常提币/转账;
- 冻结账户(如果发现大量异常交易);
- 改密码+重置2FA(有些攻击者会用API反推账号信息)。
持续监控(24小时内)
- 关注邮箱是否有新的API调用通知;
- 每小时检查一次持仓和余额;
- 查看GitHub、代码仓库、云存储是否还有密钥泄露源;
- 开启币安的登录异地通知;
- 如果涉及资金损失,联系客服启动申诉流程。
长期加固(7天内)
- 清理所有历史代码仓库里可能泄露的密钥;
- 设置GitHub Secret Scanning;
- 把所有API用法改成环境变量;
- 服务器加固(改SSH端口、上防火墙);
- 考虑用硬件密钥做双重验证。
API key泄露后哪些钱最危险
按照被盗概率排序。
- 现货余额:如果开了现货交易权限,会被对方挂市价单低价卖出,再用另一账户接盘。俗称"洗单"。
- 合约账户:开了合约权限的话,对方会开大杠杆反向开仓,让你爆仓。
- 链上资产:如果开了提币权限且没设地址白名单,几分钟提光。
- 历史订单隐私:只开读取权限也能被看到持仓、交易记录,影响隐私。
- 被当做僵尸账户:加入到攻击者的"刷量"矩阵里,产生大量小额交易。
常见问题
API key能重置Secret吗
不能。Secret只在创建时显示一次,之后再也看不到。如果Secret丢了或泄露,只能删除旧API key重新创建。
API key的权限可以随时修改吗
可以。在API管理里编辑,修改权限、IP白名单即可。修改后需要用2FA验证。
币安API Key有过期时间吗
在高级权限开启后(如提币权限),币安会要求设定有效期,默认最多90天。到期自动失效。普通API key没有硬性过期,但长期不用会被币安定期清理。
同一个账号能创建多少API key
上限通常30个左右。建议一个业务一个key,方便管理和隔离。
子账户的API key和主账户隔离吗
是的,完全隔离。子账户API只能操作子账户资产,访问不到主账户。这也是为什么大资金推荐用子账户跑策略。
API请求的限频规则是什么
现货约每秒1200权重,合约约每秒2400权重。单个IP每分钟约6000请求。量化策略要做好限频处理,否则会触发封禁。详情参考币安API官方文档。
总结
API key的风险完全取决于你的配置,不是取决于它本身。三条金科玉律:①权限最小化(能不开就不开),②IP白名单必开(绑你的服务器IP),③定期轮换(30-90天一换)。加上永远不把Secret提交到代码仓库这条自律,你的API安全等级就能跻身顶部。量化交易者尤其要把API安全看得和资金安全同等重要——它本身就是资金的一把钥匙。现在就打开 币安官网 API管理页面,把所有不用的、超过90天的API全部删掉,给剩下的补上IP白名单。