API对接币安交易所常见问题解答

最近不少朋友在群里问 API b安交易所 对接的事，说照着文档搞了半天老是报错，要么签名过不去，要么提示权限不足，搞得头都大了。我自己前前后后对接过好几个币安API的项目，从最开始的现货接口到后面的合约、提现接口，踩过的坑真不少。今天就把大家问得最多的几个问题整理一下，用大白话讲清楚怎么排查、怎么解决，希望能帮到正在折腾 API b安交易所 的你。

Binance全球顶级交易所 v3.20.4

类型：金融理财大小：293.6M语言：多国语言[中文]时间：9-15评分：10.0

API b安交易所怎么创建？创建时要注意什么？

先说最基础的，很多人连API Key都没搞明白就开始写代码了。登录币安官网，进到账户中心，找到API管理那个入口，点创建API。这时候会让你起个名字，随便写个自己能记住的就行。

创建完之后会弹出API Key和Secret Key，Secret Key只显示这一次，关了窗口就再也看不到了，所以一定要先复制下来存好。我刚开始搞的时候就是手快点了确定，结果Secret Key没存，只能删了重建，白白浪费一次机会。

另外创建的时候会要求绑定谷歌验证或者手机验证，这个步骤别跳过，不然后面权限开不了。还有一点，创建API的时候可以勾选权限，如果你只是读取行情数据，就只勾“启用读取”，千万别手贱把提现权限也开了，万一Key泄露了哭都来不及。

说到权限，就不得不提IP白名单了。币安现在对新创建的API Key有强制要求，必须绑定IP白名单才能使用。很多人创建完直接拿去跑代码，结果一直报“Invalid API-key, IP, or permissions”，其实就是没加白名单。把你服务器的公网IP填进去就行，如果本地测试就填本机IP。注意别填错了，我之前把内网IP填进去，排查了半天才发现问题。

对接时一直报签名错误是怎么回事？

签名错误可以说是 API b安交易所 对接过程中出现频率最高的问题了，没有之一。报错信息一般是“Signature for this request is not valid”或者类似的提示。

这个问题原因挺多的，我挨个说。第一个常见原因是参数顺序搞错了。币安的签名要求是把所有参数按字母顺序排列，然后拼接成查询字符串再去做HMAC SHA256加密。很多人直接用代码里参数的插入顺序去拼，那肯定不对。建议用TreeMap或者类似的自动排序结构来处理。

第二个原因是时间戳不同步。币安要求请求里的timestamp参数和服务器时间差不能超过1000毫秒，也就是1秒。如果你服务器时间不准，或者网络延迟太大，就会报“Timestamp for this request is outside of the recvWindow”。解决办法很简单，服务器上装个NTP同步一下时间就行。我自己用的是阿里云的主机，默认时间还挺准的，但有一次不知道怎么就漂了几秒，折腾了好久才发现。

第三个原因是Secret Key复制的时候多了空格或者少了字符。这个真的很隐蔽，肉眼看不出来。建议复制的时候用编辑器的显示空白字符功能检查一下，或者干脆重新复制一遍。

欧易okx交易所 v6.188.0

类型：金融理财大小：379.8M语言：中文时间：9-11评分：10.0

API请求频率限制怎么破？被限流了怎么办？

币安对API请求是有频率限制的，不同接口的权重不一样。现货接口一般限制在每分钟1200个权重，合约接口是2400。你用多了就会返回429状态码，意思是“请求太多，慢点”。

如果被限流了，千万别头铁继续猛发请求，那样可能会被封IP甚至封号。正确的做法是看到429就停下来，等一会儿再试。币安返回的头信息里会有“Retry-After”字段，告诉你等多少秒。我一般会设置一个退避策略，第一次等1秒，第二次等2秒，第三次等4秒，以此类推。

另外很多人不注意权重消耗，比如批量下单接口，你一次下10单和一次下1单，权重消耗差很多。建议把能合并的请求合并掉，比如查询多个交易对的行情，能用一次请求搞定的就别分多次。

还有个坑是WebSocket和REST API的限流是分开算的，如果你对实时性要求高，可以考虑用WebSocket订阅行情，能省不少REST请求的额度。

提现接口对接有什么坑？安全吗？

提现接口是很多人关心的，毕竟涉及到资金安全。首先说结论：币安API提现本身是安全的，但前提是你自己别作死。

提现接口必须开启“启用提现”权限才能用，而且必须绑定IP白名单，这两个条件缺一不可。另外币安还要求提现地址必须提前在地址簿里添加过，并且通过邮箱或谷歌验证确认，API才能提到那个地址。这个设计其实是为了防止API Key泄露之后被人把钱转走。

我自己的做法是，提现权限单独创建一个API Key，和跑策略的Key分开。跑策略的Key只开读取和交易权限，不开提现。这样即使策略的Key不小心泄露了，最多被人乱交易，钱转不走。提现的Key平时不用，需要提的时候临时开一下，提完马上删掉或者禁用。

还有一点，提现接口有金额限制，单笔和每日都有上限，具体看你账户的VIP等级。如果你要提的金额比较大，可能需要分几天提，或者升级VIP等级。

API b安交易所支持哪些编程语言？有现成的SDK吗？

币安的REST API和WebSocket API都是基于HTTP和WS协议的，所以理论上任何支持网络请求的编程语言都能对接。Python、Java、Go、Node.js、C#这些主流语言都没问题。

官方其实提供了不少SDK，在GitHub上能搜到，Python的、Java的、Node.js的都有。不过说实话，官方SDK的更新速度有时候跟不上API的变化，而且文档写得比较简略。我个人的习惯是直接用HTTP库自己封装，反而更灵活，出问题了也好排查。

如果你用Python，requests库就够了；Java的话用OkHttp或者HttpClient；Go用标准库的net/http。WebSocket的话Python用websockets，Java用Java-WebSocket，都有成熟的库。

有一点要注意，不同语言的签名实现方式可能略有差异，比如HMAC SHA256的输出格式，有的语言默认是bytes，需要转成hex字符串。这个在对接的时候要特别留意，不然签名老是对不上。

测试网和正式网有什么区别？新手应该先用哪个？

币安提供了测试网（Testnet），强烈建议新手先在测试网上把流程跑通再去正式网。测试网的API域名和正式网不一样，需要单独申请测试网的API Key。

测试网的好处是，里面的钱是假的，随便你怎么折腾都不会亏。你可以用测试网来验证签名逻辑、测试下单流程、调试异常处理。我刚开始对接的时候就是在测试网上跑了整整一周，把所有能想到的边界情况都测了一遍，才敢上正式网。

不过测试网也有缺点，深度不如正式网，有些冷门交易对可能没有数据，而且行情波动和正式网也不完全一样。所以测试网跑通之后，正式网上还是要先用小资金试一下，确认没问题再放大。

另外测试网的API文档和正式网是同一套，但有些接口在测试网上可能不支持，比如提现接口测试网就没有。这个要注意一下，别在测试网上找半天找不到提现的接口。

API b安交易所对接后怎么做异常监控？

代码写完了能跑通只是第一步，上线之后的监控才是重头戏。我见过太多人代码跑起来就不管了，结果API Key过期了、IP变了、余额不足了都不知道，等发现的时候已经亏了不少。

建议至少监控这几个东西：API请求的成功率，如果失败率突然升高，可能是限流了或者Key出问题了；账户余额，低于某个阈值就报警；订单状态，有没有卡住的订单；网络延迟，延迟太高会影响下单速度。

监控工具的话，简单的可以用邮件或者钉钉机器人报警，复杂一点的可以上Prometheus加Grafana。我自己是用Python写了个小脚本，每隔几分钟检查一次关键指标，有问题就发钉钉消息，够用了。

还有一点，API Key要定期更换，建议每个月换一次。换的时候注意新旧Key要有一段重叠期，别直接删了旧的导致服务中断。

好了，关于 API b安交易所 对接的常见问题差不多就是这些。总结一下就是：创建Key的时候注意权限和IP白名单，签名错误先查参数顺序和时间戳，被限流了要退避别硬刚，提现权限单独管理，新手先上测试网，上线后做好监控。把这些都做到了，基本上能避开90%的坑。如果还有别的问题，欢迎在评论区留言，我看到都会回。