bi安 API 接口调用教程：新手常见问题与解决方案

最近好多朋友在折腾 bi安 API 接口，说实话，我第一次用的时候也踩了不少坑，什么认证失败、请求超时、签名对不上，各种稀奇古怪的问题，搞得人脑壳疼。今天我就把这段时间积累的经验整理一下，专门针对新手常见的 bi安 API 调用问题，给大家一个接地气的解决方案。不管你是刚开始接触，还是已经调得头皮发麻，这篇文章都能帮你少走弯路。

Binance全球顶级交易所 v3.19.8最新版

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

咱们不说那些虚头巴脑的理论，直接讲实操。我用的是 PHP 语言测试的，但思路是通用的，不管你是用 Python、Java 还是 Go，只要是调 bi安 API，核心逻辑都一样。下面我按大家问得最多的几个问题来拆解。

bi安 API 怎么申请？需要什么条件？

很多新手连 bi安 API 都还没申请下来，就开始问怎么调。其实申请很简单，登录 bi安 官网，在账户设置里找到 API 管理，点创建 API 就行。这里要提醒一下，创建的时候会让你选择权限，别全选了，建议只勾你需要的，比如行情读取和交易权限，安全第一。

另外，创建完一定要把 Secret Key 保存好，这玩意儿只显示一次，丢了就只能重新生成。我当初就是没保存好，后来重新生成了一次，还耽误了半天时间。

申请好之后，你需要把你的 API Key 和 Secret Key 放到代码里，但注意，千万别直接写在公开的仓库里，不然容易被别人盗用。

bi安 API 请求超时怎么办？是不是服务器问题？

这个我太有发言权了，我第一次调 bi安 API 的时候，老是超时，一开始我还以为是 bi安 服务器不行，后来才发现是我自己的网络问题。bi安 的服务器在国外，咱们访问的时候延迟本来就高，尤其是用一些不稳定的代理，那超时概率更大。

解决方法是：用稳定一点的网络，或者把超时时间设置得长一点，比如 PHP 里 cURL 的超时时间我设成了 30 秒。另外，如果你请求频率太高，也会被 bi安 API 限流，导致超时。这时候你就得控制请求频率，别一次性发太多请求。

对了，还有一个小技巧，就是检查一下你的服务器时间是不是和北京时间同步，如果时间偏差太大，签名会验证失败，也会报错。这个我后面会细说。

bi安 API 签名错误怎么排查？

说到签名，这绝对是新手最容易翻车的地方。bi安 API 的签名机制是 HMAC SHA256，你得用 Secret Key 对请求参数做哈希。很多人搞不清楚到底要对哪些参数签名，顺序是什么，一不小心就错了。

我建议你把参数按照字母序排序，然后拼成字符串，再加上 timestamp 和 recvWindow，最后用 HMAC SHA256 加密。如果你还是对不上，可以先在 bi安 官方文档里用那个测试工具试试，看你的签名是不是和它生成的一致。如果一致，那问题就出在你的请求参数上，比如多了个空格，或者某个参数大小写不对。

还有一点，timestamp 要精确到毫秒，而且你的服务器时间要和 bi安 服务器时间差不能超过 1000 毫秒（默认是 5000 毫秒，但你最好设成 2000 毫秒以内）。我建议你在代码里先获取一下 bi安 服务器时间接口，然后做个差值校准。

bi安 API 怎么获取行情数据，比如 K 线？

获取 K 线是很多人的刚需，比如做量化交易或者写个小工具。bi安 API 的 K 线接口路径是 /api/v3/klines，参数有 symbol、interval、limit 这些。symbol 就是交易对，比如 BTCUSDT，interval 是 K 线周期，比如 1m、15m、1h 这些。

这里有个坑，就是 symbol 必须大写，而且中间不能有空格。我之前就是没注意大小写，一直报错，后来才发现是这个问题。接口返回的数据是一个二维数组，包含开高低收、成交量这些，但它是字符串格式，你需要自己转成浮点数。

另外，interval 参数只支持特定的几个值，像 1m、3m、5m、15m、30m、1h、2h、4h、6h、8h、12h、1d、3d、1w、1M，你要是写个 10m 就报错了。

bi安 API 下单总是失败？看看这些细节

下单接口是 /api/v3/order，需要传 symbol、side（BUY/SELL）、type（LIMIT/MARKET）这些。如果你是限价单，还要传 price 和 quantity。很多新手容易忽略 quantity 的精度，不同交易对的最小数量不一样，比如有的要求 0.001 个，你传 0.0001 就报错。

还有，你要注意下单前先查一下交易规则，bi安 API 有个接口叫 exchangeInfo，里面列出了所有交易对的精度和最小下单量。我每次下单前都会先拉一下这个，动态获取精度，这样就不会因为精度问题报错了。

另外，如果你用的是测试网，那 API 地址和正式的不一样，别搞混了。测试网的 Key 也要单独申请。

bi安 API 如何避免被限制访问？

这个其实很简单，就是控制请求频率。bi安 API 对每个 IP 的请求次数有限制，比如每分钟 1200 次（具体看接口）。如果你超过了，就会被暂时限制，返回 429 错误。我的建议是，写代码的时候加个限速，比如每次请求后 sleep 200 毫秒，这样基本不会触发限制。

还有，如果你要用 WebSocket 订阅行情，那也要注意连接数，别开太多。我一般就开一个连接，然后订阅多个交易对。

bi安 API 常见报错代码都是什么意思？

新手最容易懵的就是看到一堆错误码，比如 -1121、-2015、-1003 这些。我列几个常见的：-1121 表示参数不合法，比如 symbol 传错了；-2015 表示 API Key 无效或者签名错误；-1003 表示请求被限制，可能是频率太高。

遇到错误不要慌，先看错误消息里的描述，一般都会告诉你具体原因。如果实在看不懂，就把错误码复制到百度搜一下，或者去 bi安 API 文档里查。

bi安 API 调用教程总结，送你几个小建议

最后总结一下，bi安 API 调用其实不难，主要就是注意细节。我建议新手先注册一个测试网账号，在测试环境里多练练，等熟悉了再用真钱。另外，一定要把官方文档看一遍，虽然有些地方写得不清楚，但大部分问题都能在里面找到答案。

如果你在调 bi安 API 过程中遇到其他奇葩问题，欢迎留言交流，我看到就会回复。咱们互相学习，少踩坑，多赚钱！