在使用 Binance（币安）进行交易或数据获取时，开发者或高频交易者经常会与 Binance API 打交道，在调用 API 的过程中，你可能会遇到各种 HTTP 状态码，400 Bad Request 是一个相对常见的错误，本文将详细解析 Binance API 400 错误的含义、常见原因、排查方法以及如何有效解决，帮助你更顺畅地使用 API。

什么是 Binance API 400 错误

HTTP 状态码 400 Bad Request 表示服务器（Binance API 服务器）无法理解或处理客户端（你的应用程序）发送的请求，这通常意味着请求本身存在问题，而不是服务器出现故障，对于 Binance API 而言，400 错误通常意味着你的请求格式不正确、缺少必要参数、参数值无效，或者违反了 API 的使用规则。

当你收到 400 错误时，Binance API 的响应体中通常会包含更详细的错误信息,这是排查问题的关键。

导致 Binance API 400 错误的常见原因

  1. 请求参数错误或格式不正确：

    • 缺少必需参数： 在创建订单时，缺少 symbol（交易对）、side（买卖方向）、type（订单类型）、quantity（数量）等必需参数。
    • 参数拼写错误： 参数名拼写错误，例如将 symbol 写成 simbol。
    • 参数值类型错误： 将需要数字的参数（如 quantity）传入了字符串，或者将需要字符串的参数（如 symbol）传入了数字。
    • 参数格式错误： 时间戳格式不正确，或者交易对格式不符合规范（如应为 BTCUSDT 而写成了 btc/usdt）。

  2. API 密钥或签名问题：

    • API Key 无效或未启用： 使用的 API Key 不存在、已过期、或者未启用相应的权限（如交易权限）。
    • 签名错误： 这是最常见也是最需要仔细检查的地方。
      • Secret Key 错误： 使用的 Secret Key 与 API Key 不匹配。
      • 签名算法错误： 未按照 Binance API 文档指定的 HMAC-SHA256 算法进行签名。
      • 签名参数缺失或顺序错误： 用于生成签名的参数列表不完整，或者参数的排列顺序不正确（通常需要按照参数名的字母顺序排序）。
      • 编码问题： 在生成签名前，未对参数进行正确的 URL 编码（尽管 Binance API 的某些端点可能对参数值有特定编码要求，但签名过程通常使用原始参数值）。

  3. 请求频率或权重超限：

    • 虽然更常见的是 429 Too Many Requests 错误，但在某些情况下，过于频繁的请求或在短时间内发送大量请求，也可能触发 400 错误，尤其是在涉及权重较高的接口时，Binance API 有 IP 级别和 API Key 级别的请求频率限制。

  4. 订单参数不符合规则：

    • 数量精度问题：<
      随机配图
      /strong> 下单数量不符合交易对的最小精度要求或步长要求。
    • 价格精度问题： 下单价格不符合交易对的最小价格精度要求。
    • 资金不足： 虽然通常返回 insufficient balance 或类似错误，但在某些边缘情况下，也可能表现为 400 错误。
    • 订单类型与参数不匹配： 使用 LIMIT 订单类型时未提供 price 参数，或者使用 MARKET 订单类型时提供了 price 参数。
    • 无效的订单状态或操作： 尝试取消一个已经取消或成交的订单。

  5. 时间戳问题：

    • Binance API 要求所有请求（除了 GET /api/v3/ping）都必须包含 timestamp 参数,用于防止重放攻击。
    • 时间戳偏差过大： 你的本地服务器时间与 Binance API 服务器时间偏差过大（通常允许偏差在 1 秒以内），这会导致签名验证失败，从而返回 400 错误，错误信息通常会提示 Timestamp for this request was X ms ahead of server time 或类似信息。

  6. JSON 格式错误：

    对于需要发送 JSON 请求体的接口（如创建订单），JSON 格式不正确（例如缺少引号、逗号使用错误、括号不匹配等），服务器将无法解析，从而返回 400 错误。

如何排查和解决 Binance API 400 错误

遇到 400 错误时，不要慌张,按照以下步骤进行排查：

  1. 仔细阅读 API 响应错误信息：

    • 这是最重要的一步！Binance API 的 400 响应通常会包含一个 code 字段（错误码）和一个 msg 字段（错误描述）。
      {
    "code": -1102,
    "msg": "Mandatory parameter 'symbol' was not sent, was empty/null, or is wrong."
}
    • 根据错误码和错误信息，直接定位到问题所在。-1102 表示缺少必需参数 symbol。

  2. 检查 API 密钥和签名：

    • 确认 API Key 和 Secret Key 是否正确无误,且已启用相应权限。
    • 严格按照文档生成签名：
      • 确保所有必需参数都已包含。
      • 将参数按字典序排序。
      • 将排序后的参数键值对用 & 连接,形成查询字符串。
      • 使用 HMAC-SHA256 算法，以 Secret Key 为密钥,对上述查询字符串进行签名。
      • 将生成的签名（十六进制小写）作为 signature 参数附加到请求中。
    • 可以使用 Binance API 文档中提供的签名验证示例来测试你的签名逻辑是否正确。

  3. 验证请求参数：

    • 检查所有必需参数是否都已提供且拼写正确。
    • 检查参数值的类型是否符合 API 文档要求（字符串、数字、布尔值等）。
    • 检查交易对格式是否正确（通常是 BASEQUOTE 格式，如 BTCUSDT，区分大小写）。
    • 检查数量和价格精度是否符合对应交易对的规定（可以通过 GET /api/v3/exchangeInfo 接口获取）。

  4. 同步服务器时间：

    • 获取 Binance API 的服务器时间：GET /api/v3/time。
    • 将你的本地服务器时间与 Binance 服务器时间进行同步，确保偏差在允许范围内，在你的代码中，可以直接使用 Binance 返回的服务器时间戳来构造请求中的 timestamp 参数。

  5. 检查请求频率：

    • 确保你的请求频率没有超过 Binance API 的限制，可以通过查看 API 响应头中的 X-MBX-USED-WEIGHT（当前 IP 的已用权重）和 X-MBX-ORDER-COUNT-10S（10秒内的订单计数）等信息来监控。

  6. 检查 JSON 请求体（如果适用）：

    如果是 POST/PUT 请求且包含 JSON 请求体，确保 JSON 格式完全正确，可以使用 JSON 格式化工具或在线验证器进行检查。

  7. 查阅 Binance API 文档：

    遇到不明确的错误或不确定某个接口的参数要求时，务必查阅最新的 Binance API 文档,文档是开发者最好的朋友。

Binance API 400 错误虽然常见，但通常都是由于客户端请求本身存在问题导致的，通过仔细分析 API 返回的错误信息，严格检查请求参数、API 签名、时间同步以及遵守 API 使用规则，绝大多数 400 错误都可以被有效排查和解决，养成良好的编码习惯，例如在发送请求前进行参数校验，并在开发过程中充分测试，可以大大减少此类错误的发生，希望本文能帮助你更好地理解和解决 Binance API 400 错误，让你的 API 调用更加顺畅高效。