币安Kraken API错误：2024新手交易者如何快速排查？

阅读：82 分类： 资源

币安 Kraken API 接口错误码详解

加密货币交易者在使用币安和Kraken等交易所提供的API接口进行自动化交易时，经常会遇到各种各样的错误。了解这些错误码的含义对于快速诊断和解决问题至关重要。本文将详细解析币安和Kraken API接口中常见的错误码，帮助交易者更好地理解和应对这些错误。

币安API错误码详解

币安的API错误响应通常以JSON格式返回，提供关于请求失败的详细信息。主要的错误信息包含在 code 和 msg 字段中。 code 字段是一个整数，代表特定的错误类型，而 msg 字段则是一个人类可读的字符串，提供关于错误的描述和可能原因。

在开发与币安API交互的应用程序时，正确处理这些错误码至关重要，可以帮助开发者诊断问题、改进代码的健壮性，并为用户提供有用的错误信息。

以下是币安API常见的错误码及其含义，以及一些建议的处理方法：

  • -1000: 未知/未定义的错误

    • 这意味着服务器遇到了无法识别的错误，可能是由于内部问题或临时故障引起的。开发者应该记录错误并重试请求，如果问题持续存在，应联系币安支持。

  • -1001: 连接超时

    • API服务器响应时间过长，导致连接中断。这可能是由于网络拥塞或服务器负载过高引起的。建议增加请求超时时间，并实施重试机制。

  • -1002: 请求必须使用POST方法

    • API端点只接受POST请求，开发者使用了错误的HTTP方法（例如GET）。需要修改请求方法为POST。

  • -1003: 参数缺失或无效

    • 请求缺少必要的参数，或者提供的参数值无效。仔细检查请求参数，确保它们符合API文档的要求。常见的原因包括参数拼写错误、数据类型不匹配或超出范围的值。

  • -1004: 签名验证失败

    • 请求的签名无效，无法通过币安服务器的验证。这通常是由于密钥不正确、签名算法错误或时间戳偏差过大引起的。请确保使用正确的API密钥和密钥，并仔细检查签名生成过程。

  • -1005: 权限不足

    • API密钥没有访问特定端点的权限。请检查API密钥的权限设置，并确保它具有执行所需操作的权限（例如交易、提现）。

  • -1006: 过滤器失败

    • 订单不符合交易所的交易规则，例如价格超出范围或数量过小。查看交易所的交易规则，并调整订单参数以满足要求。

  • -1007: 交易对无效

    • 请求中指定的交易对不存在或无效。检查交易对是否正确拼写，并确保它在币安交易所上可用。

  • -1013: 订单提交失败

    • 服务器无法处理订单请求。这可能是由于系统过载或其他内部问题引起的。重试请求，如果问题持续存在，请联系币安支持。

  • -1021: 时间戳无效

    • 请求中的时间戳与服务器时间之间的偏差过大。同步客户端时间，并确保时间戳在允许的范围内。

  • -1022: 时间戳超过有效时间

    • 时间戳过期，表示请求发送时间过长，可能存在重放攻击的风险。建议在发送请求之前重新获取时间戳。

  • -1100: 请求参数过多或参数格式错误

    • 请求包含了过多的参数，或者某些参数的格式不正确。仔细检查请求参数，确保它们符合API文档的要求，并且没有多余的参数。

  • -2010: 帐户没有足够的余额

    • 帐户余额不足以执行交易。检查帐户余额，并确保有足够的资金来支付订单金额和交易费用。

  • -2011: 未知订单

    • 尝试取消或查询不存在的订单。检查订单ID是否正确，并确保订单尚未被完全成交或取消。

  • -2013: 订单无法取消

    • 订单状态不允许取消，例如已经完全成交或正在处理中。只有在订单处于开放状态时才能取消。

账户相关错误:

  • -1000 : 未知/内部错误。这通常指示服务器端存在问题，建议稍后重新尝试操作。如果该错误持续发生，请及时联系币安官方支持团队，并提供详细的错误信息以及操作步骤，以便他们进行问题诊断和修复。
  • -1001 : 未连接到服务器。确认您的设备已连接到互联网，并且网络连接稳定。检查防火墙设置或代理服务器是否阻止了与币安服务器的通信。尝试重启网络设备或更换网络环境。
  • -1002 : 授权失败。您的API密钥或Secret Key配置不正确，或者您所使用的API密钥不具备执行当前操作所需的足够权限。请仔细核对API密钥和Secret Key是否正确，包括大小写和空格。确保密钥已激活且未过期，并且已授予必要的交易和账户权限。如果使用的是只读密钥，则无法进行交易操作。
  • -1003 : 访问受限。您的IP地址可能被币安服务器限制访问，这可能是由于触发了安全规则或违反了币安的使用条款。请检查您的IP地址是否被列入黑名单，并确保您的操作符合币安的规定。如有疑问，请联系币安支持团队了解具体原因并申请解除限制。考虑使用VPN更换IP地址。
  • -1013 : 订单数量过低。您尝试提交的订单数量低于币安交易所规定的最小交易数量。不同交易对的最小交易数量可能不同，请参考币安API文档或交易界面的说明，确认您所交易的交易对的最小交易数量要求。
  • -1020 : 此操作不支持该symbol。您尝试在不支持交易的交易对上进行操作，或者该交易对可能已暂停交易。请检查您所选择的交易对是否正确，并确认该交易对当前是否允许交易。某些交易对可能因为流动性不足或其他原因被暂时或永久性下架。
  • -1021 : 时间戳无效。客户端设备的时间与币安服务器的时间偏差过大，导致请求被拒绝。确保您的客户端时间与服务器时间同步，可以使用网络时间协议（NTP）服务器进行时间同步。许多操作系统都内置了NTP客户端，可以自动同步时间。可以使用如`ntp.pool.org`等公共NTP服务器。
  • -1022 : 签名无效。请求的签名不正确，表明您使用的签名算法或密钥不正确，或者签名过程中使用了错误的参数。请仔细检查您的签名算法实现是否符合币安API文档的要求，并确保API密钥和Secret Key正确使用。常见的错误包括密钥输入错误、签名算法选择错误、以及参数顺序或格式错误。
  • -1100 : 请求参数无效。您的请求参数不符合币安API文档的要求，例如参数类型错误、格式不正确、取值超出范围等。请仔细阅读API文档，确认所有请求参数都符合规定的格式和取值范围。例如，某些参数可能是整数，但您传递了字符串。
  • -1101 : 交易对无效。您指定的交易对不存在或已从币安下架。请检查您所选择的交易对是否正确，并在币安官方网站或API文档中确认该交易对是否可用。下架的交易对将无法进行任何交易操作。
  • -1102 : 数量参数无效。您提供的数量参数不符合要求，例如不是正数、超过最大允许数量、或精度不符合要求。请确保数量参数为正数，并且不超过币安交易所允许的最大数量。同时，注意数量参数的小数位数是否符合交易对的精度要求。
  • -1104 : 未找到请求的订单。您尝试取消或查询的订单不存在，可能是因为该订单已经被取消、成交或从未创建。请检查您的订单ID是否正确，并确保您在正确的交易对上查询或取消订单。
  • -1111 : 精度太高。交易数量或价格的小数位数超过了交易所允许的精度。每个交易对都有其特定的精度要求，请参考币安API文档或交易界面的说明，调整您的交易数量或价格，使其符合精度要求。
  • -2008 : 余额不足。您的账户余额不足以支付交易所需的资金。请检查您的账户余额，并确保有足够的资金用于购买或出售加密货币。考虑存入更多的资金，或调整交易数量。
  • -2010 : 账户没有足够的 {asset}。您的账户中没有足够的指定资产（例如，BTC、ETH）来完成当前操作，通常是卖出订单时出现该错误。检查您的账户余额，确保您拥有足够的{asset}可供出售。
  • -2011 : UNKNOWN_ORDER。未知的订单错误，可能是由于服务器端的问题导致订单状态异常。请稍后重试，如果问题仍然存在，请联系币安支持。
  • -2013 : ORDER DOES NOT_EXIST。您尝试操作的订单不存在。请确认订单ID是否正确，并检查订单是否已被取消或成交。
  • -2014 : 订单类型不支持。您尝试使用的订单类型（例如，限价单、市价单、止损单）在该交易对上不受支持。并非所有交易对都支持所有类型的订单。请参考币安API文档或交易界面的说明，选择支持的订单类型。
  • -2015 : 交易类型不支持。您尝试使用的交易类型（例如，市价单卖空）不被支持。某些交易对或账户可能不允许使用某些高级交易类型。请检查您的账户设置和交易对的规则，确认您使用的交易类型是否被允许。
  • -2019 : 账户被冻结。您的账户可能因为安全原因被冻结，例如检测到异常活动或违反了币安的使用条款。请立即联系币安支持团队，了解账户被冻结的原因，并按照他们的指示进行解冻操作。提供必要的身份验证信息，以便尽快恢复账户。

限速相关错误:

  • -429 : 请求过多 (Too Many Requests)。您在极短的时间窗口内发送了超出API服务器承受能力的请求数量，从而触发了速率限制保护机制。 为了避免此错误，建议采取以下措施：
    • 降低请求频率： 显著降低API请求的发送速率。 例如，原本每秒发送10个请求，可以尝试降低到每秒发送2-3个请求，然后逐步增加，找到一个既能满足需求又不触发限速的最佳平衡点。
    • 使用权重更高的API（如果适用）： 某些API接口可能具有不同的权重，高权重的API允许更高的请求频率。 请查阅API文档，了解是否存在更高权重的替代方案。
    • 实现重试机制： 在程序中实现自动重试机制，当遇到 -429 错误时，暂停一段时间（例如，使用指数退避算法逐渐增加重试间隔），然后再重新发送请求。 这有助于应对偶发的限速情况。
    • 申请更高的API调用频率限制： 如果您需要更高的请求频率，可以考虑联系API提供商，说明您的使用场景和需求，申请提升API调用频率限制。 这通常需要提供详细的理由和使用计划。
    • 缓存数据： 对于一些不经常变化的数据，可以考虑在本地或服务器端进行缓存，避免频繁地向API服务器发送相同的请求。
  • -1007 : 请求超时 (Request Timeout)。服务器未能及时响应您的请求，导致连接超时。 这通常表明客户端与服务器之间的网络通信存在问题。 解决此问题的方法包括：
    • 检查网络连接： 确认您的设备已连接到互联网，并且网络连接稳定。 可以尝试访问其他网站或服务，以排除网络故障。
    • 增加超时时间： 在您的API请求中，设置一个更长的超时时间。 默认的超时时间可能不足以应对网络延迟或服务器繁忙的情况。 根据实际情况，可以将超时时间增加到30秒、60秒甚至更长。
    • 选择更快的网络： 如果条件允许，尝试使用更快的网络连接，例如光纤网络或更稳定的无线网络。
    • 优化API请求： 检查您的API请求是否过于复杂或包含大量数据。 简化请求内容，减少数据传输量，可以缩短响应时间。
    • 联系API提供商： 如果您确定网络连接没有问题，并且服务器仍然频繁超时，则可能是API服务器本身存在问题。 请联系API提供商，报告此问题并获取支持。
    • 使用CDN加速： 如果API提供商使用了CDN（内容分发网络），可以确保您正在连接到离您最近的CDN节点，以减少网络延迟。

其他错误:

  • -1016 : 服务正在维护。这通常表示币安正在进行计划内的服务器维护或系统升级。在此期间，交易平台的部分或全部功能可能暂时无法使用。建议用户稍后重新尝试访问，并关注币安官方公告了解维护的具体时间和影响范围。维护可能包括数据库优化、系统安全更新或新功能部署，以提升平台整体性能和用户体验。
  • -1017 : 系统繁忙。此错误代码表明服务器当前负载过高，无法及时响应新的请求。造成系统繁忙的原因可能包括突发交易量激增、DDoS攻击或其他技术问题。建议用户稍后重试，或尝试降低交易频率。同时，可以使用币安提供的API接口的限速功能，避免过度请求。币安也会采取措施缓解服务器压力，例如增加服务器资源、优化数据库查询等。

Kraken API错误码详解

Kraken交易所的API错误处理机制与币安等其他交易所略有不同。在Kraken的API响应中，错误信息并非通过单一的错误代码或状态码来传递，而是封装在一个名为 error 的数组中。这个数组是错误信息的核心载体，它能够容纳多个错误描述字符串，从而提供更为详细和全面的错误诊断信息。

error 数组中的每个元素都是一个字符串，这些字符串清晰地描述了在API请求处理过程中出现的特定错误。这种设计允许API同时报告多个相关的错误，使得开发者能够更准确地定位问题，从而加速调试和故障排除的过程。

理解和解析 error 数组的内容对于成功集成Kraken API至关重要。开发者需要编写相应的代码来解析这些错误信息，并根据不同的错误类型采取适当的措施，例如重新提交请求、调整请求参数，或者通知用户出现了问题。

以下是Kraken API中一些常见的错误码及其详细的含义，掌握这些错误码有助于开发者更好地理解和处理API返回的错误信息：

请求相关错误:

  • EAPI:Invalid key : 无效的API密钥。请务必仔细检查您提供的API密钥是否与Kraken交易所账户关联的密钥完全一致，包括大小写。确保API密钥已激活，并且没有过期。如果API密钥是新创建的，请等待几分钟以便其生效。
  • EAPI:Invalid nonce : 无效的Nonce。Nonce是一个单调递增的数字，用于防止重放攻击。每个API请求的Nonce值必须大于之前使用的Nonce值。建议使用时间戳作为Nonce，以确保其唯一性和递增性。请注意，高并发情况下可能需要考虑更复杂的Nonce生成策略。
  • EAPI:Authentication failed : 身份验证失败。通常是由于API密钥和Secret Key不匹配，或者用于生成签名的参数不正确。请确认您使用的API密钥和Secret Key是从Kraken交易所账户正确复制的。同时，请仔细检查签名算法的实现，确保请求参数的排序、编码和哈希过程与Kraken交易所的要求完全一致。查看官方文档和示例代码可以帮助排查签名错误。
  • EGeneral:Internal error : 内部错误。这表明Kraken交易所服务器端出现问题，与您的API请求无关。建议稍后重试，并查看Kraken交易所的状态页面或社交媒体渠道，以了解是否有任何已知的中断或维护。如果问题持续存在，请联系Kraken交易所的技术支持。
  • EGeneral:Permission denied : 权限被拒绝。您的API密钥可能没有足够的权限执行该操作。请检查您的API密钥权限设置，确保其具有执行所需操作（例如，下单、查询余额）的权限。不同的API密钥可以具有不同的权限级别。您可以在Kraken交易所账户设置中管理API密钥的权限。
  • EGeneral:Too many requests : 请求过多。您触发了Kraken交易所的限速机制。为了保护系统免受滥用，Kraken交易所对API请求的频率进行了限制。请实施适当的速率限制策略，例如使用指数退避算法，以避免超过限速。检查Kraken交易所的API文档，了解具体的限速规则和建议的请求频率。
  • EGeneral:Service unavailable : 服务不可用。Kraken交易所可能正在进行计划内或计划外的维护。请稍后重试，并查看Kraken交易所的状态页面或社交媒体渠道，以了解维护的预计持续时间。服务不可用也可能表示服务器负载过高，此时稍后重试通常可以解决问题。

订单相关错误:

  • EOrder:Invalid order : 无效的订单。该错误表明提交的订单参数存在问题，可能是参数缺失、格式错误或数值超出范围。请仔细检查订单的各个字段，例如交易对、价格、数量和订单类型，确保其符合交易所的规范要求。部分交易所对订单参数有严格的格式要求，例如价格精度和数量精度，需要特别注意。
  • EOrder:Insufficient funds : 资金不足。账户可用余额不足以支付订单所需的资金。这不仅包括购买加密货币所需的资金，还可能包括交易手续费。请检查账户余额，并确保有足够的资金来覆盖订单总成本。部分交易所允许使用杠杆交易，但即使使用了杠杆，也需要一定的保证金才能下单。
  • EOrder:Order minimum not met : 未达到最小订单量。交易所对每种交易对都设定了最小交易数量限制。您尝试交易的数量低于此限制，导致订单被拒绝。请查询交易所的交易规则，了解每种交易对的最小交易数量，并调整订单数量以满足要求。
  • EOrder:Invalid price : 无效的价格。订单中指定的价格不符合交易所的要求。这可能是因为价格精度不正确，或者价格超出了允许的波动范围。交易所通常会限制订单价格与市场价格的偏离程度，以防止恶意操作。请检查价格格式和数值，确保其在合理范围内。
  • EOrder:Insufficient volume : 交易量不足。您尝试交易的数量超过了交易所允许的最大数量或市场深度不足以支持该交易量。交易所会限制单个订单的最大交易数量，以防止大额订单对市场造成过度冲击。如果市场深度不足，您的订单可能无法完全成交。
  • EOrder:Cannot open position : 无法开仓。通常发生在杠杆交易中，表示您可能没有足够的保证金来开立新的仓位。开立杠杆仓位需要一定的保证金作为抵押，如果账户保证金不足，则无法开仓。请检查账户保证金余额，并根据交易所的保证金要求进行调整。
  • EOrder:Leverage restriction : 杠杆限制。您尝试使用的杠杆倍数超出交易所允许的最大杠杆倍数。不同的交易所和不同的交易对可能有不同的杠杆限制。请查阅交易所的规则，了解允许的最大杠杆倍数，并调整您的杠杆设置。
  • EOrder:Order type invalid : 订单类型无效。您尝试使用的订单类型不受交易所支持。交易所支持多种订单类型，例如市价单、限价单、止损单等。并非所有交易所都支持所有订单类型。请确认交易所支持您使用的订单类型，并确保订单参数与订单类型匹配。
  • EOrder:Order price outside allowable range : 订单价格超出允许范围。您设置的价格过高或过低，超出了交易所允许的波动范围。交易所通常会对订单价格设置上下限，以防止价格操纵。请检查您设置的价格，并确保其在合理范围内，接近当前市场价格。
  • EOrder:Closing position size exceeds size of open positions : 平仓数量超过开仓数量。您尝试平仓的数量大于您当前持有的仓位数量。这通常发生在您尝试平掉一个不存在的仓位或平仓数量大于现有持仓时。请检查您的持仓情况，并调整平仓数量以匹配您的实际持仓。

其他错误:

  • EQuery:Unknown asset pair : 未知的交易对。您指定的交易对在交易所或数据源中不存在。这可能是由于您输入了错误的交易对代码（例如，将BTCUSD误写为BTCCNY），或者该交易对根本未被交易所支持。请仔细检查交易对代码，并确认交易所提供该交易对的交易或数据服务。一些交易所可能仅提供有限数量的交易对，尤其是在涉及流动性较低的代币时。某些 API 接口可能需要特定的交易对格式，例如使用下划线（_）或斜杠（/）分隔不同的资产，因此请务必参考相应的 API 文档。如果问题仍然存在，请考虑尝试使用其他交易所或数据源，或者联系交易所的客服支持。
  • EQuery:Unknown position : 未知的仓位。您尝试查询或操作一个不存在的仓位。这通常发生在您在交易平台或 API 中尝试访问一个已经平仓、不存在，或者您没有权限访问的仓位时。请确保您输入的仓位 ID 正确，并且该仓位确实存在于您的账户中。某些交易平台可能只允许查询或操作当前持有的仓位，而无法访问历史仓位数据。另外，权限问题也可能导致此错误，例如，如果您的 API 密钥没有足够的权限来访问特定仓位的信息。检查您的账户历史记录，确认该仓位是否已被关闭或转移。如果问题依然存在，请与您的经纪商或交易平台的客户支持联系，以便他们可以进一步调查并解决问题。

Nonce的处理:

在加密货币交易和API交互中，Nonce（Number used once）是一个至关重要的安全机制，主要用于防止重放攻击。重放攻击是指攻击者截获并重新发送合法的交易或请求，从而达到欺骗系统的目的。Nonce的本质是一个递增的或唯一的数值，每个请求都必须携带一个与之前不同的Nonce值。这意味着，每次向交易所或API服务器发送请求时，Nonce的值必须严格大于上一次使用的值，否则服务器会拒绝该请求，将其视为潜在的重放攻击。如果Nonce处理不当，最常见的错误提示是 EAPI:Invalid nonce ，表明服务器检测到Nonce无效。

  • 持久化存储上一次使用的Nonce值： 这是最常见的解决方案。客户端需要将上一次成功发送请求时使用的Nonce值安全地保存在本地存储中（例如，数据库、文件或内存），以便在下一次请求时作为参考。
  • 递增Nonce值： 在每次发送新的API请求之前，从本地存储中检索上一次使用的Nonce值，然后将其加1。新的Nonce值用于当前请求，并且在请求成功发送后，更新本地存储中的Nonce值，以备后续使用。务必确保递增操作是原子性的，尤其是在多线程或分布式环境中，以避免并发问题导致Nonce重复。
  • 使用时间戳作为Nonce值： 另一种方法是使用当前时间戳（例如，自Unix纪元以来的毫秒数）作为Nonce值。这种方法的优势在于简单易实现，无需维护单独的Nonce计数器。然而，关键在于时间戳的精度必须足够高，通常需要毫秒级精度，以确保在短时间内生成的Nonce值不会重复。需要考虑时钟同步问题。客户端和服务器之间的时钟差异可能导致Nonce失效，因此建议使用网络时间协议（NTP）同步客户端时钟，或者允许服务器接受一定范围内的Nonce值，以容忍轻微的时钟偏差。

错误处理的重要性：币安与 Kraken API 错误码详解

在加密货币自动化交易领域，高效且稳定的交易策略至关重要。 理解并妥善处理币安（Binance）和 Kraken 等交易所的应用程序编程接口（API）返回的错误码，是构建此类策略的关键一环。错误处理不当可能导致交易失败、资金损失，甚至账户被冻结。

当交易程序遇到错误时，首要步骤是仔细阅读 API 返回的错误信息。这些信息通常包含错误码和错误描述，能帮助开发者迅速定位问题。务必关注错误信息的细节，例如时间戳、请求参数等，以便进行更深入的分析。

为了更好地应对错误，我们提供了币安和 Kraken 常见的错误码列表，以及针对每个错误码的详细解释和建议解决方案。例如，常见的 "Invalid API-key format" 错误通常表示 API 密钥格式不正确或缺失。 解决方案是检查API密钥是否正确配置，并在请求头中正确传递。又如，"Insufficient Funds" 错误表明账户余额不足以完成交易，需要充值或调整交易量。

除错误码列表外，还需强调持续关注交易所的官方 API 文档和更新的重要性。交易所可能会定期更新 API 接口、增加新的错误码或修改现有错误码的含义。及时了解这些更新，并相应地调整交易程序，是保持程序稳定性和兼容性的必要措施。API 文档通常会包含详细的错误码说明，以及最佳实践和示例代码，对开发者大有裨益。

构建完善的错误处理机制是稳定可靠的交易策略的基础。一个好的错误处理机制应包括以下几个方面：错误检测、错误记录、错误恢复和错误通知。例如，当检测到 "Order does not exist" 错误时，可以记录该错误，并尝试重新提交订单，或通知交易员进行人工干预。通过周全的错误处理，可以最大限度地减少交易中断，并提高交易效率。