KrakenAPI交易报错？2024开发者必看排查指南！

Kraken API 接口错误排查指南

在使用 Kraken API 进行交易和数据获取时，开发者可能会遇到各种错误。理解这些错误的含义并掌握排查方法至关重要，这可以避免程序中断、资金损失，并保证交易策略的有效执行。本文将深入探讨 Kraken API 中常见的错误类型，并提供详细的排查步骤和解决方法。

常见的 Kraken API 错误类型

Kraken API 的错误信息通常以 JSON 格式返回，包含 error 字段。该字段是一个数组，其中每个元素都是一个详细的错误描述字符串，有助于开发者诊断和解决问题。这些错误根据其性质和来源，可以细分为以下几个主要类别，理解这些类别有助于更有效地处理 API 交互中遇到的问题：

身份验证错误（Authentication Errors）：指 API 密钥相关的错误，常见于权限验证阶段。
- EAPI:Invalid key : API 密钥无效或已被撤销。这意味着密钥可能已过期、被用户主动撤销或被 Kraken 系统检测为存在安全风险而被禁用。请检查密钥是否正确，并确保其状态有效。
- EAPI:Invalid signature : 数字签名无效，通常是由于密钥不匹配、时间戳错误或请求参数构造错误导致。数字签名用于验证请求的完整性和来源，确保在传输过程中未被篡改。请仔细检查用于生成签名的密钥、时间戳和请求参数是否正确。注意时间戳的同步，以及参数顺序和编码是否符合 Kraken 的要求。
- EAPI:Key not found : 系统找不到提供的 API 密钥。请确认您提供的 API 密钥确实存在于您的 Kraken 账户中，且拼写正确。
- EAPI:Rate limit exceeded : API 请求频率超过了限制。Kraken 为了防止滥用和保护系统稳定，对 API 请求的频率进行了限制。如果您频繁收到此错误，请考虑优化您的代码，减少请求频率，或者使用 Kraken 提供的 WebSocket API 以获取实时数据，减少对 REST API 的轮询。可以通过查看 Kraken API 的文档了解具体的请求频率限制策略，并使用合适的重试机制。
参数错误（Parameter Errors）：指请求 API 时提供的参数不符合规范。
- EGeneral:Invalid arguments : 请求参数无效，例如数据类型错误、格式错误或超出允许范围。请仔细检查您提供的参数类型是否正确（例如，字符串、整数、浮点数），以及参数的格式是否符合 Kraken 的要求（例如，日期格式、货币对格式）。同时，确保参数的值在允许的范围内。
- EGeneral:Argument not applicable : 提供的参数不适用于当前请求的 API 端点。不同的 API 端点接受不同的参数。请仔细阅读 Kraken API 的文档，确认您提供的参数适用于您正在调用的 API 端点。
- EGeneral:Argument exceeds maximum length : 参数长度超过了允许的最大长度。有些参数的长度是有限制的，例如，订单备注的长度。请确保您提供的参数长度不超过 Kraken 规定的最大长度。
- EOrder:Invalid order : 订单参数无效，例如价格或数量不符合市场规则。这通常意味着您提交的订单价格超出市场合理范围，或者订单数量不符合 Kraken 规定的最小或最大交易量。请检查市场深度，并确保您的订单参数在合理的范围内。
订单错误（Order Errors）：指在下单过程中遇到的错误，通常与账户状态或市场规则有关。
- EOrder:Insufficient funds : 账户余额不足以执行订单。请检查您的账户余额是否足够支付订单所需的资金，包括交易手续费。
- EOrder:Order minimum not met : 订单金额低于交易所允许的最低限额。Kraken 对每种交易对都有最低交易额的限制。请确保您的订单金额高于 Kraken 规定的最低限额。
- EOrder:Post only order cancelled : 作为 "post-only" 订单提交，但未能立即成交，因此被取消。"post-only" 订单是指只能挂单，不能立即成交的订单。如果您的 "post-only" 订单在提交后立即与市场上的现有订单成交，它将被取消，以确保您始终是挂单方。
- EOrder:Leverage restriction : 使用的杠杆倍数超出允许的范围。Kraken 对不同的交易对和账户等级允许的杠杆倍数不同。请确保您使用的杠杆倍数在允许的范围内。
- EOrder:Order type invalid : 订单类型无效，例如不支持的订单类型。Kraken 支持多种订单类型，例如市价单、限价单、止损单等。请确保您使用的订单类型是 Kraken 支持的，并且适用于您当前的交易策略。
网络和服务器错误（Network and Server Errors）：指由于网络问题或 Kraken 服务器问题导致的错误。
- EGeneral:Temporary error, try again later : 服务器暂时错误，建议稍后重试。这通常是由于 Kraken 服务器繁忙或正在维护。请稍等片刻后重试。
- EGeneral:Service unavailable : 服务不可用，通常是由于服务器维护或故障引起。请稍后访问 Kraken 网站或 API，或关注 Kraken 的官方公告。
- EGeneral:Timeout : 请求超时，可能是由于网络连接问题或服务器负载过高导致。请检查您的网络连接是否正常，并尝试增加请求的超时时间。
其他错误（Other Errors）：无法归入上述类别的其他错误。
- EAPI:Permission denied : 当前 API 密钥没有执行请求操作的权限。请检查您的 API 密钥是否具有执行该操作所需的权限。您可以在 Kraken 账户中修改 API 密钥的权限设置。
- EGeneral:Internal error : 服务器内部错误，需要联系 Kraken 支持团队。这通常是由于 Kraken 服务器内部出现未知错误。请联系 Kraken 支持团队，并提供详细的错误信息，以便他们能够尽快解决问题。

Kraken API 接口错误排查步骤

当遇到 Kraken API 错误时，精准诊断至关重要。遵循以下细致的步骤，可以有效地排查并解决潜在的问题，确保您的交易顺利进行：

检查错误信息： 也是最关键的一步，是仔细、完整地阅读 API 返回的错误信息。这些信息通常包含了关于错误原因的关键线索和诊断信息。例如，如果错误信息显示 EAPI:Invalid key ，这通常明确指示您的 API 密钥存在问题，可能是无效、过期或格式错误。
验证 API 密钥和签名： 确保您使用的 API 密钥仍然有效，并且没有被您自己或 Kraken 撤销。即使密钥看似有效，也强烈建议您重新生成 API 密钥，特别是当您怀疑密钥可能被泄露时。仔细检查您的数字签名算法的实现，这是保证 API 请求安全的关键。验证签名时，需要使用正确的密钥、精确的时间戳和完整的请求参数。务必按照 Kraken 官方文档的规范生成签名。为了避免签名算法中的潜在错误，强烈推荐使用 Kraken 官方提供的 SDK，或经过广泛验证的第三方库来生成签名。手动实现签名算法容易出错，可能导致身份验证失败。
核对请求参数： 仔细检查请求参数的名称、数据类型、格式和取值范围。确保所有必需的参数都已提供，并且参数值符合 Kraken API 的严格规范。遗漏参数或参数值不符合规范都会导致 API 调用失败。参考 Kraken API 的官方文档，这是确认参数正确性的唯一权威来源。例如，某些参数可能需要特定的日期格式或数字范围。
检查账户余额和权限： 如果您的 API 调用涉及到交易操作，必须确保您的账户余额足够支付交易费用，并且您的 API 密钥拥有执行该操作的权限。在 Kraken 账户设置中，您可以清晰地查看和精确地修改 API 密钥的权限。权限设置不当会导致 API 调用被拒绝。仔细审查您的 API 密钥权限，确保其与您计划执行的操作相符。
监控 API 请求频率： Kraken API 对请求频率有限制，这是为了保护服务器免受滥用。如果您的请求频率超过了限制，您将会收到 EAPI:Rate limit exceeded 错误。仔细阅读并遵守 Kraken API 的文档，了解不同 API 接口的请求频率限制。合理控制 API 请求的频率至关重要。您可以使用延时函数、消息队列或其他流量控制机制来避免超过限制。实施有效的速率限制策略可以确保您的 API 调用始终能够成功。
检查网络连接： 确保您的网络连接稳定可靠，并且可以正常访问 Kraken API 服务器。不稳定的网络连接会导致 API 调用失败或超时。您可以使用 ping 命令或 traceroute 命令来检查网络连接。如果网络连接存在问题，请仔细检查您的防火墙设置、代理设置或 DNS 设置。某些防火墙或代理服务器可能会阻止对 Kraken API 服务器的访问。
查看 Kraken 状态页面： 在 Kraken 的状态页面（通常可以在 Kraken 官方网站上可以轻松找到）查看是否有服务器维护或故障报告。如果 Kraken 服务器出现问题，您的 API 调用可能会受到影响。在这种情况下，您可能需要等待服务器恢复正常后再重试。Kraken 状态页面会提供关于服务器状态的实时更新。
使用 API 测试工具： 使用 Postman、curl 或其他 API 测试工具来模拟 API 请求。这可以帮助您隔离问题，并确定错误是否是由您的客户端代码引起的。通过 API 测试工具，您可以方便地修改请求参数，并查看服务器的响应。这些工具可以帮助您诊断 API 调用中的潜在问题，例如参数错误或身份验证失败。
查阅 Kraken API 文档和社区： 仔细阅读 Kraken API 的官方文档，了解 API 的使用方法和限制。官方文档是了解 API 功能和正确使用方法的最佳资源。搜索 Kraken 社区论坛、Stack Overflow 或其他技术论坛，查看是否有其他开发者遇到类似的问题。社区论坛可以提供有用的故障排除技巧和解决方案。
联系 Kraken 支持团队： 如果以上步骤都无法解决问题，您可以联系 Kraken 的支持团队寻求帮助。在联系支持团队时，请提供详细的错误信息、请求参数、API 密钥和相关的代码片段。提供尽可能多的信息可以帮助支持团队更快地诊断并解决您的问题。

实际案例分析

案例 1： `EAPI:Invalid signature` 错误

一位开发者在使用 Kraken API 创建订单时，遭遇了令人困扰的 EAPI:Invalid signature 错误。此错误通常表明请求的签名与服务器端计算的签名不匹配，意味着验证过程失败，订单无法成功提交。经过详细的调试和问题排查，根本原因最终锁定在时间戳精度问题上。Kraken API 对时间戳有着严格的要求，必须是标准的 Unix 时间戳（以秒为单位）。而该开发者在生成签名时，使用的是毫秒级的时间戳。尽管时间戳本身是有效的，但由于精度不匹配，导致签名算法计算出的哈希值与 Kraken 服务器预期的不一致，从而触发了签名无效的错误。解决办法是将开发者端生成的时间戳从毫秒级转换为秒级，确保与 Kraken API 的规范完全一致。转换后的 Unix 时间戳被正确地包含在 API 请求中，重新计算的签名通过验证，订单创建过程得以顺利完成。更具体地说，开发者可能使用了诸如 Date.now() 之类的 JavaScript 函数，它返回的是自 Unix 纪元以来的毫秒数，需要除以 1000 才能得到正确的秒级时间戳。在其他编程语言中，也有类似的函数需要注意单位的转换。为了避免时钟同步问题，建议在生产环境中定期同步服务器时间，例如使用 NTP（网络时间协议）。

案例 2： `EOrder:Insufficient funds` 错误

另一位开发者在尝试执行市价单时遭遇了 EOrder:Insufficient funds 错误。深入调查后确认，问题根源在于账户可用余额不足以支撑按当时市场价格执行的订单需求量。具体来说，这意味着开发者尝试购买的加密货币数量乘以市价超过了账户内的可用资金。为了解决这一问题，开发者采取了调整订单数量的策略，显著降低了订单的总价值，使其低于账户余额的上限。调整后，交易顺利完成。

除了调整订单数量，还有另一种解决方案可供选择：在执行订单之前，向账户充值足够的资金。通过增加账户余额，开发者可以确保拥有足够的资金来满足订单需求，从而避免 EOrder:Insufficient funds 错误的发生。这种方法尤其适用于需要购买特定数量的加密货币且不希望减少订单数量的情况。

案例 3： `EAPI:Rate limit exceeded` 错误

一位加密货币交易平台的开发者在使用 Kraken API 获取历史交易数据时，经常遭遇 EAPI:Rate limit exceeded 错误。深入分析后，确认问题源于该开发者在极短的时间窗口内，向 Kraken 服务器发送了超出 API 速率限制的大量请求，触发了平台的流量控制机制。

为了有效解决此问题，开发者采取了以下策略：

引入延时机制： 在代码中实施了精细化的延时函数，主动控制 API 请求的发送频率。通过限制每秒或每分钟的请求数量，确保 API 请求速率符合 Kraken 的规定，避免触发速率限制。具体实现时，需要根据 Kraken 官方文档提供的速率限制参数，合理设置延时时间。
利用 WebSocket API： 开发者充分利用 Kraken 提供的 WebSocket API，通过订阅实时交易数据流，大幅减少了对 REST API 的高频请求。WebSocket 允许建立持久连接，服务器可以主动推送数据，从而避免了客户端频繁轮询 REST API 获取最新数据的需求。这不仅降低了请求频率，还提高了数据获取的实时性。
优化数据请求逻辑： 开发者还应该检查其请求数据的逻辑，避免不必要的请求。例如，如果只需要特定时间范围内的数据，应明确指定开始和结束时间，避免获取整个历史数据集。使用分页查询也是一个好办法，将大数据集分解成更小的块，并分批次请求。
使用 API 密钥的不同权限： Kraken API 支持不同权限的密钥。如果开发者只需要读取数据，应该使用只读权限的密钥，避免误操作导致不必要的 API 调用。

通过以上多管齐下的措施，该开发者成功避免了 EAPI:Rate limit exceeded 错误，保证了数据获取的稳定性和效率，同时遵守了 Kraken API 的使用条款。

预防措施

为了最大程度地避免 Kraken API 错误，确保交易流程的顺畅和程序的稳定性，可以采取以下一系列预防措施：

深入研读 Kraken API 官方文档： 这是理解 API 工作原理、参数要求、速率限制以及错误代码含义的基础。务必仔细阅读并理解官方文档的每个细节，尤其关注版本更新带来的变化。官方文档通常包含示例代码和最佳实践，能够帮助开发者快速上手并避免常见错误。
采用 Kraken 官方 SDK 或经过验证的第三方库： Kraken 官方提供的 SDK 经过了严格的测试和验证，能够有效地处理 API 通信中的各种细节，减少出错的可能性。如果选择使用第三方库，务必确保其经过社区广泛验证，并且与 Kraken API 的最新版本兼容。避免使用未经测试或维护的库，以免引入潜在的安全风险或兼容性问题。
实施严格的 API 请求频率控制： Kraken API 对请求频率有限制，超出限制会导致请求被拒绝。因此，需要合理规划 API 请求，避免短时间内发送大量请求。可以采用诸如令牌桶或漏桶算法等技术，对 API 请求进行速率限制，确保请求频率在允许范围内。同时，需要仔细阅读 Kraken API 的官方文档，了解具体的速率限制策略，并据此调整请求频率。
定期审查 API 密钥的有效性和权限： API 密钥是访问 Kraken API 的凭证，务必妥善保管。定期检查 API 密钥的有效性，确保密钥没有过期或被泄露。同时，根据实际需要，为 API 密钥配置最小必要的权限，避免赋予过高的权限，降低安全风险。可以使用 Kraken 提供的 API 管理工具，方便地管理和维护 API 密钥。
密切关注 Kraken 状态页面： Kraken 会在其状态页面上发布关于系统维护、升级或突发事件的信息。通过定期监控状态页面，可以及时了解 Kraken 系统的运行状况，避免在系统维护期间发送 API 请求，从而减少出错的可能性。可以将 Kraken 状态页面添加到收藏夹或使用监控工具，以便及时获取最新的状态信息。
构建健壮的错误处理机制： 编写完善的错误处理代码是应对 API 错误的必要手段。在代码中加入对 API 错误代码的判断和处理逻辑，能够及时发现并解决问题。对于常见的错误，例如请求超时、参数错误、权限不足等，可以采取重试、参数修正、权限申请等措施。同时，需要将错误信息记录到日志中，方便后续的排查和分析。