Kraken API 避坑指南：3 大常见问题及安全策略详解

Kraken 交易所 API 使用常见问题

Kraken 交易所提供强大的 API 接口，允许开发者和交易者自动执行交易策略、获取市场数据、管理账户等。然而，在使用过程中，用户可能会遇到各种问题。本文旨在解答一些 Kraken API 使用过程中常见的疑问，帮助你更顺利地利用 Kraken API。

一、API 密钥管理与安全

问题：如何创建和管理 API 密钥？

Kraken API 密钥的创建和管理对于保护您的账户至关重要。不当的密钥管理可能导致资金损失或数据泄露。请务必仔细阅读以下步骤，并严格遵循最佳安全实践。

1. 登录 Kraken 账户： 使用您的用户名和密码（或双重身份验证）登录您的 Kraken 账户。确保您访问的是官方 Kraken 网站，以避免网络钓鱼攻击。
2. 导航至 API 设置： 登录后，在用户界面中寻找 "安全"、"API" 或类似的选项。通常，您可以在账户设置或个人资料区域找到 API 管理界面。在某些情况下，可能需要点击“我的账户”或类似的选项才能找到相关设置。
3. 创建新密钥： 在 API 设置页面，点击 "创建新密钥"、"添加密钥" 或类似的按钮。系统将引导您完成密钥创建流程。
4. 设置权限： 这是 API 密钥管理中最关键的环节。您需要精确控制 API 密钥可以执行的操作。 只授予执行特定任务所需的最低权限。绝对不要授予不必要的权限，这会显著降低安全风险。 例如，如果您只需要获取实时的市场数据，则只需授予只读权限，切勿授予交易或提现权限。以下是常见的权限类型及其详细说明：
   • 交易 (Trade): 允许使用 API 进行买卖操作，包括下单、取消订单和修改订单。如果您使用交易机器人或编写自动交易程序，则需要此权限。请务必谨慎使用此权限。
   • 查询余额 (Query Funds): 允许查询账户中的各种加密货币和法币余额。对于监控账户资产或开发资产管理工具，此权限至关重要。
   • 查询订单 (Query Orders): 允许查询未结订单、历史订单和订单详细信息。这对于跟踪交易活动和分析交易策略非常有用。
   • 提现 (Withdraw Funds): 允许通过 API 发起提现请求，将资金转移到外部地址。 此权限风险极高，务必谨慎授予。强烈建议在授予此权限时启用双重身份验证 (2FA)，并设置提现地址白名单。
   • 查询历史交易 (Query Ledgers): 允许查询账户的历史交易记录，包括存款、提现、交易和手续费等。这对于税务申报和审计非常有用。
   • 获取市场数据 (Read-only): 仅允许获取市场数据，例如价格、交易量和订单簿信息。不允许进行任何交易或资金操作。 这是最安全的权限选项，适用于大多数只需要监控市场数据的应用程序。 选择此权限可以有效防止因密钥泄露而造成的潜在损失。
5. 设置密钥描述： 为每个 API 密钥添加清晰、简洁的描述，说明其用途。例如，“交易机器人 (ETH/USD)”、“市场数据分析 (BTC/EUR)”、“个人资产监控”。清晰的描述有助于您在日后轻松区分不同的密钥，并更好地管理您的 API 访问权限。
6. 生成密钥： 确认权限设置和描述后，点击 "生成密钥"、"创建 API 密钥" 或类似的按钮。系统将生成 API 密钥 (API Key) 和 API 密钥私钥 (Private Key)。 API 密钥用于标识您的账户，而 API 密钥私钥用于验证您的身份。请务必妥善保管您的私钥，切勿泄露给任何人。 密钥和私钥通常只会显示一次，请立即保存！
7. 存储密钥： 安全地存储 API 密钥和私钥。 切勿将它们存储在明文文件中，例如文本文件或电子表格。 强烈建议使用密码管理器（例如 LastPass、1Password）或硬件钱包（例如 Ledger、Trezor）来加密存储您的密钥。考虑使用环境变量或配置文件来管理您的密钥，避免将密钥硬编码到您的应用程序中。定期审查和更新您的 API 密钥，以确保安全性。

问题：API 密钥泄露后该怎么办？

如果你的 API 密钥不幸泄露，务必立即采取果断措施，以最大限度地降低潜在损失并保护你的账户安全。

1. 立即禁用泄露的密钥： 登录你的 Kraken 账户，导航至 API 设置页面。找到已泄露的 API 密钥，毫不犹豫地立即禁用或彻底删除它。禁用密钥会使其立即失效，阻止任何未经授权的访问和交易。
2. 创建新密钥： 禁用旧密钥后，立即创建一组全新的 API 密钥。在配置新密钥时，务必遵循最小权限原则。这意味着只授予 API 密钥执行其特定任务所需的最低权限。避免授予不必要的权限，以减少潜在的攻击面。考虑使用更复杂的密钥生成策略，例如使用更长的密钥长度和包含各种字符类型，以提高密钥的安全性。
3. 审查账户活动： 密钥泄露后，密切监控你的 Kraken 账户活动至关重要。仔细检查你的交易历史记录，寻找任何未经授权的交易、异常活动或可疑行为。特别留意你没有发起的交易、意外的资金转移或任何其他不符合你交易模式的活动。同时，检查你的账户设置，确保没有未经授权的更改，例如更改提款地址或账户信息。
4. 联系 Kraken 客服： 迅速向 Kraken 客服报告 API 密钥泄露事件。他们将能够提供额外的支持，协助你监控你的账户安全，并提供进一步的指导。提供尽可能多的关于泄露的信息，包括密钥泄露的时间和地点，以及任何可疑活动的详细信息。Kraken 客服团队可以帮助你识别潜在的风险，并采取必要的措施来保护你的账户免受损害。

问题：如何保护 API 密钥？

保护 API 密钥的安全是任何使用加密货币交易所 API 的开发者的首要任务。 泄露的 API 密钥可能导致资金损失或数据泄露。以下是一些经过验证的安全实践，可以帮助您保护您的 API 密钥：

• 使用强密码管理器： 强烈建议使用信誉良好且功能强大的密码管理器，例如 LastPass、1Password、Bitwarden 或 KeePass 等。 这些工具不仅可以安全地存储您的 API 密钥、私钥和账户密码，还可以生成复杂且唯一的密码，并自动填充登录信息，降低人为错误的可能性。 密码管理器通常采用高级加密技术来保护存储的数据，并提供多因素身份验证功能，以增强安全性。
• 定期更换密钥： 就像定期更改任何敏感密码一样，定期更换 API 密钥是降低密钥泄露风险的关键步骤。 Kraken 以及其他交易所通常允许用户生成新的 API 密钥并停用旧的密钥。 建议根据您的安全策略，每 30 天、60 天或 90 天更换一次密钥。更换密钥后，务必立即更新所有使用该密钥的应用程序和脚本。
• 限制 IP 地址： 这是增强 API 密钥安全性的强大方法。 Kraken 和许多其他交易所允许您配置 API 密钥，使其只能从预定义的 IP 地址列表进行访问。 这意味着即使攻击者获得了您的 API 密钥，如果他们的 IP 地址不在允许的列表中，他们也无法使用该密钥。 始终将允许的 IP 地址列表限制为只有您信任的服务器和计算机。
• 启用双重验证 (2FA)： 双重验证 (2FA) 为您的 Kraken 账户增加了一层额外的安全保护。 启用 2FA 后，除了您的密码之外，您还需要提供一个来自您的手机或其他身份验证设备的验证码才能登录。 这使得攻击者更难以未经授权地访问您的账户，即使他们已经获得了您的密码。 始终为您的 Kraken 账户以及与加密货币相关的任何其他服务启用 2FA。常用的 2FA 方式包括基于时间的一次性密码（TOTP）应用，如 Google Authenticator、Authy 和 Microsoft Authenticator。
• 不要在公共场所使用 API 密钥： 避免在公共网络（如咖啡馆或机场的 Wi-Fi）或不安全的计算机上使用 API 密钥。 公共网络通常不安全，容易受到黑客攻击。 如果您必须在公共场所使用 API 密钥，请务必使用 VPN（虚拟专用网络）来加密您的互联网连接，并确保您的计算机上安装了最新的安全补丁和防病毒软件。 考虑使用移动热点而不是公共 Wi-Fi。
• 小心钓鱼攻击： 钓鱼攻击是一种常见的欺诈手段，攻击者试图通过伪装成可信的实体（例如 Kraken 或其他加密货币交易所）来诱骗您泄露您的 API 密钥、账户信息或其他敏感数据。 警惕通过电子邮件、短信或其他渠道收到的可疑消息。 仔细检查发件人的电子邮件地址，并避免点击任何可疑链接或下载任何可疑附件。 如果您不确定消息的真实性，请直接联系 Kraken 的官方支持团队进行验证。
• 使用 HTTPS 加密： 确保您的 API 请求始终使用 HTTPS 加密。 HTTPS（超文本传输安全协议）是一种安全的通信协议，可在您的计算机和服务器之间建立加密连接。 这可以防止数据在传输过程中被窃取或篡改。 验证您正在使用的 API 端点是否以 `https://` 开头。 仔细检查您使用的任何加密货币交易所或服务的 SSL/TLS 证书，以确保它们是有效的且未被篡改。

二、API 调用与错误处理

问题：API 调用频率限制是多少？

为保障平台稳定运行并防止服务器过载，Kraken 对所有 API 调用均设有频率限制。这些限制根据具体 API 接口的功能和用户账户的等级而有所不同。高频调用可能导致请求被限制，影响数据获取和交易执行。

API 频率限制的设计旨在确保所有用户都能公平地访问 Kraken 平台资源，防止恶意攻击和滥用行为，保障平台的安全性和可用性。超出限制可能导致账户被暂时或永久禁用。

• Tier 1 账户: 作为入门级账户，通常适用于小型交易者或初学者，因此 API 调用频率限制相对较低。适用于对数据请求频率要求不高的用户。
• Tier 2 账户: 适用于中等规模的交易者，API 调用频率限制相应提高，允许更频繁地访问市场数据和执行交易指令。
• Tier 3 账户: 为活跃交易者和机构客户设计，提供最高的 API 调用频率限制，满足高频交易和复杂策略的需求。

为了了解您的账户等级对应的具体频率限制，请务必查阅 Kraken 官方 API 文档，该文档详细列出了每个 API 接口的允许调用次数和时间间隔。API 文档通常会说明不同接口的权重，某些计算密集型或数据量大的接口可能会消耗更高的频率配额。

如果您的 API 调用超过设定的频率限制，您将会收到包含特定错误代码的响应。常见的错误代码包括 429 Too Many Requests 。您需要根据错误信息适当调整 API 调用策略，降低调用频率，或者考虑升级您的账户等级，以获得更高的频率限制。合理利用缓存机制，避免重复请求相同的数据，也能有效降低 API 调用频率。

在设计您的 API 应用程序时，建议实施错误处理机制，以便在遇到频率限制错误时能够自动暂停请求或进行指数退避重试。同时，监控您的 API 调用使用情况，及时发现并解决潜在的频率限制问题。

问题：如何处理 Kraken API 错误？

与 Kraken API 交互时，可能会遇到各种错误。 Kraken API 返回的错误代码和相应的错误信息是诊断和解决问题的关键。理解这些错误代码和信息，能帮助开发者迅速定位问题根源并采取适当的措施。以下列出了一些常见的 Kraken API 错误，并提供了处理这些错误的建议：

• EAPI:Invalid nonce: 非法的 Nonce 值。 Nonce (Number used once) 是一个用于防止重放攻击的安全机制，它必须是单调递增的整数。这意味着每次 API 请求时，你的 Nonce 值必须大于上次请求使用的 Nonce 值。常见的错误原因是 Nonce 值重复使用、小于上次使用的值，或与服务器时间不同步。 解决方法包括：
  • 确保 Nonce 值生成逻辑的正确性。
  • 同步客户端和服务器的时间。
  • 使用持久化存储（如数据库或缓存）来跟踪 Nonce 值。
  • 如果使用多线程或分布式系统，需要考虑 Nonce 值的并发控制。
• EAPI:Rate limit exceeded: 超过了 API 调用频率限制。 Kraken API 为了保护服务器资源，对每个用户或 IP 地址都有调用频率限制。 如果超过此限制，API 将返回此错误。 解决方法包括：
  • 降低 API 调用频率，避免在短时间内发送大量请求。
  • 使用 API 的批量请求功能（如果可用），将多个请求合并为一个请求。
  • 实现重试机制，当遇到频率限制错误时，等待一段时间后重试。 使用指数退避算法来逐渐增加重试间隔，可以更有效地避免再次触发频率限制。
  • 检查是否有其他应用或脚本也在使用同一个 API 密钥，并消耗了频率限制。
• EGeneral:Invalid arguments: API 请求参数无效。这表明你发送的 API 请求中的参数不正确或缺失。 解决方法包括：
  • 仔细检查 API 请求中的所有参数名称、数据类型和格式是否符合 Kraken API 文档的要求。
  • 确保必填参数都已提供，并且参数值在有效范围内。
  • 检查参数之间是否存在冲突或依赖关系，确保它们组合在一起是有效的。
  • 验证参数值的长度、字符集和特殊字符是否符合要求。
• EOrder:Insufficient funds: 账户余额不足以执行交易。 解决方法包括：
  • 检查你的 Kraken 账户余额是否足够支付交易所需的资金，包括交易费用。
  • 考虑部分成交的可能性。如果账户余额略低于所需金额，可以尝试调整订单数量或价格，以确保订单能够成交。
  • 检查是否有挂单占用了可用余额。如果账户中有未成交的订单，这些订单可能会占用部分可用余额。
  • 确认是否有资金正在提现过程中，这会减少可用余额。
• EOrder:Order minimum not met: 交易金额低于交易所的最低交易额。 Kraken 交易所对每种交易对都设置了最低交易额。 如果你的交易金额低于此限制，API 将返回此错误。 解决方法包括：
  • 查阅 Kraken API 文档或交易所的交易规则，了解特定交易对的最低交易额。
  • 调整订单数量或价格，使交易金额达到或超过最低交易额。
  • 考虑使用 Kraken 提供的其他交易对，这些交易对可能具有更低的最低交易额。

当遇到 Kraken API 错误时，请采取以下步骤进行排查和解决：

1. 阅读错误信息： 仔细阅读 API 返回的错误信息。错误信息通常会提供关于错误的详细描述和建议的解决方法。 关注错误代码，它能帮助你快速定位问题类型。
2. 检查 API 请求参数： 仔细检查你的 API 请求参数，包括参数名称、数据类型、格式和取值范围。 确保所有必填参数都已提供，并且参数值符合 API 文档的要求。
3. 调整 API 调用频率： 如果遇到频率限制错误，请降低 API 调用频率。 实现重试机制，并在重试之间增加适当的延迟。 使用指数退避算法来动态调整重试间隔。
4. 检查账户余额： 如果遇到资金不足错误，请检查你的 Kraken 账户余额是否足够支付交易所需的资金，包括交易费用。 考虑未成交订单和提现请求对可用余额的影响。
5. 查阅 API 文档： Kraken 提供了详细的 API 文档，其中包含了关于 API 使用、错误代码和解决方案的详细信息。 仔细阅读 API 文档，可以帮助你更好地理解 API 的工作原理和如何解决问题。
6. 联系 Kraken 客服： 如果你尝试了以上方法仍然无法解决问题，请联系 Kraken 客服寻求帮助。 提供详细的错误信息、API 请求和账户信息，以便客服能够更好地帮助你解决问题。

问题：如何获取历史交易数据？

通过Kraken API可以获取详细的历史交易数据，这对于市场分析、算法交易和风险管理至关重要。Kraken API提供了 Trades 接口，允许开发者查询指定交易对在特定时间范围内的交易记录。这些数据包括成交价格、成交量、时间戳以及买卖方向等关键信息。需要注意的是，Kraken API对请求频率有限制，开发者应合理设计程序，避免超出限制。

使用Kraken API获取历史交易数据通常涉及以下步骤：创建一个Kraken API客户端实例。然后，构造请求参数，包括交易对（例如，'XBT/USD'，代表比特币/美元）、起始时间和结束时间。接着，调用 Trades 接口，并解析返回的JSON数据。将数据存储到本地，例如使用CSV文件或数据库，以便后续分析和使用。

以下是一个使用Python和 krakenex 库获取历史交易数据的示例代码：

import krakenex
import pandas as pd
import time
from datetime import datetime, timedelta

# 初始化Kraken API客户端
k = krakenex.API()

# 交易对
pair = 'XBT/USD'

# 起始时间（Unix时间戳）
start_time = int(time.mktime((datetime.now() - timedelta(days=7)).timetuple()))  # 获取过去7天的数据

# 定义一个函数来获取交易数据
def get_kraken_trades(pair, since):
    trades = []
    while True:
        resp = k.query_public('Trades', {'pair': pair, 'since': since})
        if resp['error']:
            print(f"Error: {resp['error']}")
            break
        trades.extend(resp['result'][pair])
        since = resp['result']['last']
        print(f"Got {len(trades)} trades, last timestamp: {since}")
        if len(resp['result'][pair]) == 0: # No more trades available
            break
        time.sleep(1) # Respect rate limits
    return trades

# 调用函数获取交易数据
trades_data = get_kraken_trades(pair, start_time)

# 将数据转换为Pandas DataFrame
df = pd.DataFrame(trades_data, columns=['price', 'volume', 'time', 'buy_sell', 'market_limit', 'miscellaneous'])
df['time'] = pd.to_datetime(df['time'], unit='s')  # Convert Unix timestamp to datetime

# 打印DataFrame
print(df.head())

# 保存到CSV文件
df.to_csv('kraken_trades.csv', index=False)

此代码段演示了如何使用 krakenex 库连接到Kraken API，并循环获取指定交易对的历史交易数据。 为了避免触发API速率限制，添加了 time.sleep(1) ，每次请求后暂停1秒。获取到的数据转换为 Pandas DataFrame，并保存到 CSV 文件。开发者可以根据实际需求调整代码，例如修改交易对、时间范围或数据存储方式。还需要处理API返回的错误信息，以确保程序的健壮性。

请注意，在实际应用中，务必妥善保管API密钥，并遵循Kraken API的使用条款和速率限制。详细的API文档和使用说明可在Kraken官方网站上找到。

初始化 Kraken API 客户端

为了与 Kraken 交易所进行交互，你需要初始化 Kraken API 客户端。这通常涉及到导入 `krakenex` 库并加载你的 API 密钥对，密钥对包含公共密钥和私有密钥，用于身份验证和授权访问 Kraken 账户。

以下代码展示了如何使用 `krakenex` 库初始化 API 客户端：

import krakenex

# 创建 Kraken API 客户端实例
k = krakenex.API()

# 从文件中加载 API 密钥
# 'kraken.key' 文件应包含两行：
# 第一行是 API 密钥 (public key)
# 第二行是私有密钥 (private key)
k.load_key('kraken.key')

#或者直接设置API密钥
#k = krakenex.API(key="Your Public Key", secret="Your Private Key")

重要提示：

• 请务必妥善保管你的 API 密钥，避免泄露。不要将 API 密钥硬编码到代码中，而是通过安全的方式加载，例如从文件中读取或使用环境变量。
• `kraken.key` 文件的格式应为纯文本，第一行为你的 API 公钥，第二行为你的 API 私钥。
• 在生产环境中，建议使用更安全的方式存储和管理 API 密钥，例如使用密钥管理服务。
• API密钥的权限需要根据你的使用场景进行配置。例如，如果只需要获取市场数据，可以只授予只读权限。
• 在调用任何API之前，请仔细阅读 Kraken API 的文档，了解每个 API 的参数和返回值。
• 请注意 Kraken API 的使用限制，避免超出限制而被封禁。

完成初始化后，你就可以使用 `k` 对象调用 Kraken API 的各种方法，例如查询账户余额、下单、取消订单等。

示例：获取账户余额

# 调用 API 获取账户余额
balance = k.query_private('Balance')

# 打印账户余额
print(balance)

获取 BTC/USD 交易对的历史交易数据

为了检索 BTC/USD 交易对的历史交易数据，我们需要构建一个包含必要参数的字典。该字典将传递给 Kraken API。其中， pair 键指定了交易对（在本例中为 'XXBTZUSD'，代表 BTC/USD），而 since 键则指定了起始时间戳，用于限定返回数据的起始时间。时间戳以 Unix 时间格式表示，即自 1970 年 1 月 1 日午夜（UTC）以来经过的秒数。

params = {'pair': 'XXBTZUSD', 'since': '1609459200'} # 2021年1月1日的时间戳

以下代码块展示了如何利用 krakenex 库与 Kraken API 进行交互，并处理可能发生的错误。代码尝试向 Kraken API 发送请求，查询指定交易对的历史交易数据。如果 API 返回错误，则会打印错误信息。否则，将提取交易数据并将其转换为 Pandas DataFrame，以便于进一步分析和处理。DataFrame 的列包括价格、交易量、时间戳、买/卖方向、市价/限价单类型和其他杂项信息。时间戳将被转换为可读的日期时间格式。打印 DataFrame 的前几行数据，以便快速预览数据内容。

try: result = k.query_public('Trades', params) if result['error']: print(f"Error: {result['error']}") else: trades = result['result']['XXBTZUSD'] df = pd.DataFrame(trades, columns=['price', 'volume', 'time', 'buy_sell', 'market_limit', 'misc']) df['time'] = pd.to_datetime(df['time'], unit='s') print(df.head())

except Exception as e: print(f"An error occurred: {e}")

这段代码示例展示了使用 krakenex Python 库获取 Kraken 交易所 BTC/USD 交易对历史交易数据的过程。在运行此代码之前，请确保已安装必要的库： krakenex 和 pandas 。 可以使用 pip install krakenex pandas 命令进行安装。为了使代码能够成功连接到 Kraken API，你需要拥有有效的 API 密钥对。API 密钥对应该安全地存储在你的系统上，并确保只有授权用户才能访问它们。请不要将密钥硬编码到代码中，而是使用环境变量或者专门的配置文件来管理它们。代码中的 k 对象代表一个 krakenex.API 实例，需要使用你的API 密钥进行初始化。 kraken.key 并非必须的文件， Kraken API keys可以通过其他安全方式设置。例如，可以通过环境变量或者直接在代码中设置（不推荐）。

三、交易下单与订单管理

问题：如何使用 API 下单？

你可以使用 AddOrder 接口，通常也称为“下单”接口，来执行交易操作。此接口允许你通过程序化的方式在交易所提交买入或卖出订单。 为了成功下单，你需要提供一系列的关键参数：

• 交易对 (Pair): 明确指定你希望交易的两种加密货币，例如 BTC/USD （比特币/美元）或 ETH/BTC （以太坊/比特币）。 交易对定义了交易的基础资产和报价资产。
• 交易类型 (Type): 指明交易的方向，即是买入 ( buy ) 还是卖出 ( sell )。 买入表示你希望用报价货币购买基础货币，而卖出则表示你希望出售基础货币换取报价货币。
• 订单类型 (Order Type): 选择适合你交易策略的订单类型。 常见的订单类型包括：
  • 市价单 (Market Order): 以当前市场最优价格立即执行的订单。 你只需指定交易数量，交易所会自动以当时的最佳可用价格成交。
  • 限价单 (Limit Order): 允许你设定一个特定的价格。 只有当市场价格达到或优于你设定的价格时，订单才会被执行。 限价单可以让你更好地控制交易成本，但不能保证一定成交。
  • 止损单 (Stop Loss Order): 当市场价格达到预设的止损价格时，订单将被触发并以市价单的形式执行。 止损单用于限制潜在的损失。
  • 止损限价单 (Stop Loss Limit Order): 结合了止损单和限价单的特性。 当市场价格达到止损价格时，会触发一个限价单，以你设定的限价或更优的价格执行。
  • 其他更高级的订单类型 (例如冰山订单、跟踪止损单) 可能也可用，具体取决于交易所的支持。
• 交易数量 (Volume): 指定你要买入或卖出的加密货币数量。 数量应该以基础货币单位表示。
• 价格 (Price): 对于限价单，你需要设定你愿意买入或卖出的价格。 对于市价单，通常不需要指定价格，因为订单会以当前市场价格成交。 然而，一些API可能允许你设置滑点容忍度，以控制市价单的成交价格范围。
• 杠杆 (Leverage): 如果你进行的是杠杆交易，你需要指定使用的杠杆倍数。 杠杆交易可以放大收益，但也同时增加了风险。 请谨慎使用杠杆。
• 其他参数: 一些API可能支持额外的参数，例如：
  • 有效期 (Time-in-Force): 指定订单在交易所的有效时间。
  • 只减仓 (Reduce Only): 用于只减少当前仓位的订单。
  • Post-Only: 确保订单不会立即成交，从而享受maker手续费优惠（如果交易所提供）。

以下是一个使用 Python 库 krakenex 下单的示例代码片段：

import krakenex
from pykrakenapi import KrakenAPI

# 连接到 Kraken API
k = krakenex.API()
kapi = KrakenAPI(k)

# 设置交易参数
pair = 'XXBTZUSD'  # 比特币/美元
type = 'buy'      # 买入
ordertype = 'market' # 市价单
volume = 0.01     # 交易数量 (0.01 BTC)

# 执行下单操作
try:
    data = kapi.add_order(pair, type, ordertype, volume)
    print(data)
    # 处理下单结果
    if data and data['descr']['order']:
        print(f"订单已成功提交：{data['descr']['order']}")
        print(f"交易ID: {data['txid']}") #交易ID
    else:
        print(f"下单失败: {data}")
except Exception as e:
    print(f"下单过程中发生错误: {e}")

注意事项：

• 在实际使用 API 下单之前，请务必仔细阅读交易所的 API 文档，了解所有可用参数和限制。
• 使用 API 密钥进行身份验证。 请妥善保管你的 API 密钥，不要泄露给他人。
• 在生产环境中进行交易之前，请先在测试环境（如果交易所提供）中进行充分的测试。
• 务必处理 API 返回的错误信息，并采取适当的措施。
• 请注意，加密货币交易存在风险。 请谨慎投资，并根据自己的风险承受能力进行交易。

初始化 Kraken API 客户端

要与 Kraken 交易所进行交互，第一步是初始化 Kraken API 客户端。 这需要使用 krakenex 库，并加载您的 API 密钥。 API 密钥文件应包含您的 API 密钥和私钥，务必妥善保管，避免泄露。

k = krakenex.API() 这行代码创建了一个 krakenex.API 类的实例，并将其赋值给变量 k 。 这个 k 对象将作为你与 Kraken API 交互的接口。 krakenex 库提供了与Kraken交易所进行数据交互的函数和方法。

k.load_key('kraken.key') 这行代码用于加载包含 API 密钥和私钥的文件。 将 'kraken.key' 替换为实际的 API 密钥文件路径。 该文件通常包含两行，第一行是 API 密钥，第二行是私钥。 请确保文件权限设置正确，避免未经授权的访问。 加载密钥后，客户端才能安全地向 Kraken API 发送请求。

重要提示： API 密钥是访问您的 Kraken 账户的凭证，泄露 API 密钥可能导致资金损失。 请勿将 API 密钥存储在公共代码仓库或以其他方式公开。 强烈建议使用环境变量或其他安全的方式来管理 API 密钥。 定期轮换 API 密钥是提高安全性的有效措施。 Kraken 官方文档提供了关于 API 密钥管理的详细指南，请务必仔细阅读。

下一个限价买单

本例展示如何使用 krakenex Python 库在 Kraken 交易所下一个限价买单。 限价买单允许您指定希望购买数字资产（例如比特币）的最高价格。只有当市场价格达到或低于您指定的价格时，才会执行该订单。

以下代码片段展示了创建一个限价买单所需的参数：

params = {
    'pair': 'XXBTZUSD',
    'type': 'buy',
    'ordertype': 'limit',
    'price': '30000',
    'volume': '0.01'
}

参数说明：

• pair : 指定交易的货币对。 在此示例中， XXBTZUSD 表示比特币 (XXBT) 兑美元 (ZUSD)。 Kraken 使用特定的代码来表示资产。
• type : 指定订单类型。 在这里， buy 表示买单。
• ordertype : 指定更具体的订单类型。 limit 表示限价单，意味着只有在达到指定价格时才会执行订单。
• price : 指定您愿意购买的最高价格。 在此示例中，价格设置为 30000 美元。
• volume : 指定您要购买的资产数量。 在此示例中，数量设置为 0.01 比特币。 请注意，Kraken 可能有最小订单量要求。

使用 krakenex 提交订单的代码如下:

try:
    result = k.query_private('AddOrder', params)
    if result['error']:
        print(f"Error: {result['error']}")
    else:
        print(f"Order placed: {result['result']}")
except Exception as e:
    print(f"An error occurred: {e}")

代码解释：

• k.query_private('AddOrder', params) : 使用 Kraken API 的 AddOrder 方法提交订单。 这需要 API 密钥，并且应仔细处理它们。
• 错误处理: 代码检查 API 调用的 error 字段。 如果存在错误，它将打印错误消息。
• 成功处理: 如果订单成功提交，代码将打印包含订单详细信息的 result 。
• 异常处理: try...except 块捕获任何可能发生的异常，例如网络问题或 API 连接错误。

重要提示： 在实际交易之前，请务必在 Kraken 的沙盒或测试环境中测试此代码。 API 密钥应保密，并且不应硬编码到脚本中。 使用环境变量或配置文件来安全地存储您的 API 密钥。 请始终检查 Kraken API 文档以获取最新的 API 端点和参数。

问题：如何查询订单状态？

你可以使用 QueryOrders 接口来查询特定订单的执行状态、当前状态和其他相关信息。此接口是与交易所交互的重要组成部分，它允许你跟踪订单的生命周期，从提交到完全成交或取消。

要查询订单状态，你需要提供订单 ID（ order ID ）。订单 ID 是交易所分配给每个订单的唯一标识符。 你可以通过下单接口获得订单ID。

以下是一个使用 krakenex Python 库查询订单状态的示例代码片段：

import krakenex

# 初始化 Kraken API 客户端
k = krakenex.API()
k.load_key('kraken.key') #载入API Key

# 订单 ID 列表 (可以一次查询多个订单)
order_ids = ['ORD-ID-1', 'ORD-ID-2']

# 调用 QueryOrders 接口
try:
    response = k.query_private('QueryOrders', {'txid': ','.join(order_ids)})

    if response['error']:
        print(f"错误: {response['error']}")
    else:
        orders_info = response['result']
        for order_id, order_data in orders_info.items():
            print(f"订单ID: {order_id}")
            print(f"  状态: {order_data.get('status', 'N/A')}")
            print(f"  交易对: {order_data.get('descr', {}).get('pair', 'N/A')}")
            print(f"  类型: {order_data.get('descr', {}).get('type', 'N/A')}")
            print(f"  价格: {order_data.get('descr', {}).get('price', 'N/A')}")
            print(f"  成交数量: {order_data.get('vol_exec', '0')}")
            print(f"  总数量: {order_data.get('vol', '0')}")

except Exception as e:
    print(f"发生异常: {e}")

在上面的代码中， QueryOrders 函数被调用，并将订单 ID 作为参数传递。API 返回的响应包含了订单的详细信息，包括当前状态（例如， pending 、 open 、 closed 、 canceled 、 expired ）、交易对、下单类型（市价单、限价单等）、价格和成交数量。 status 字段是确定订单执行阶段的关键。

请务必处理 API 调用可能返回的任何错误，例如无效的 API 密钥、网络连接问题或无效的订单 ID。 请注意交易所的 API 使用限制，避免过于频繁地调用 QueryOrders 接口。 考虑使用批量查询功能来减少 API 调用次数。

初始化 Kraken API 客户端

使用 krakenex 库初始化 Kraken API 客户端是与 Kraken 交易所进行交互的第一步。这个过程涉及到创建 krakenex.API() 实例以及加载你的 API 密钥。

k = krakenex.API() 这一行代码创建了一个 krakenex.API 类的实例，并将其赋值给变量 k 。这个 k 对象将成为你与 Kraken API 交互的接口。 这个API实例提供了访问Kraken交易所各种功能的接口，包括查询市场数据、下单、管理账户资金等等。

k.load_key('kraken.key') 这行代码负责从文件中加载你的 API 密钥。 请将 'kraken.key' 替换为你实际存放 API 密钥的文件名。该文件应包含两行内容，第一行是 API 密钥 (API Key)，第二行是私有密钥 (Private Key/Secret)。 正确加载 API 密钥至关重要，因为它是你通过 API 访问账户和执行交易的凭证。 请务必妥善保管你的 API 密钥文件，防止泄露。 确保该文件具有适当的权限，以防止未经授权的访问。 推荐的做法是将API密钥存储在环境变量中，并在代码中引用这些环境变量，而不是直接将密钥硬编码在代码或配置文件中。

查询订单状态

通过 Kraken API 查询订单状态，你需要使用交易 ID (txid) 作为参数。以下代码展示了如何使用 krakenex Python 库实现此功能。

参数定义:

params = { 'txid': 'O75IU-C4SFK-R55QDV' # 替换为你的订单 ID }

其中， txid 字段是必需的，用于指定要查询的订单的交易 ID。 确保将 O75IU-C4SFK-R55QDV 替换为你实际的订单 ID。无效的交易 ID 将导致 API 返回错误信息。

API 调用和结果处理:

try: result = k.query_private('QueryOrders', params) if result['error']: print(f"Error: {result['error']}") else: print(f"Order status: {result['result']}") except Exception as e: print(f"An error occurred: {e}")

这段代码首先尝试调用 Kraken API 的 QueryOrders 方法，并传递包含 txid 的 params 字典。 query_private 方法用于需要 API 密钥进行身份验证的私有 API 端点。

如果 API 返回错误，则会将错误消息打印到控制台。如果API 调用成功， result['result'] 包含订单的详细信息，包括当前状态、成交量、价格等。这些信息将打印到控制台。

try...except 块用于捕获可能发生的异常，例如网络连接问题或 API 密钥无效。如果发生异常，则会将错误消息打印到控制台。

代码说明:

这段代码示例展示了如何使用 krakenex Python 库查询订单状态。这段代码需要你预先配置好Kraken API密钥和私钥，并安装 krakenex 库。 可以使用 pip install krakenex 命令安装。

在运行代码之前，请确保已将 kraken.key 文件放置在正确的位置，并已将其中的 API 密钥和私钥正确配置到 k 对象中。 另外，将 O75IU-C4SFK-R55QDV 替换为你要查询的订单 ID。

问题：如何取消订单？

你可以使用 CancelOrder 接口来取消未成交或部分成交的订单。取消订单的关键在于准确指定需要取消的订单 ID。

取消订单的操作通常涉及与交易所API的交互。以下是一个使用 krakenex Python库取消Kraken交易所订单的示例，展示了取消订单的基本步骤和所需的关键参数。

krakenex 是一个用于与Kraken交易所API交互的Python库。 你需要先安装它：

pip install krakenex

以下是一个取消订单的代码示例：

import krakenex
from pykrakenapi import KrakenAPI

# 替换为你的API密钥和私钥
api_key = "YOUR_API_KEY"
api_secret = "YOUR_API_SECRET"

# 创建Kraken API连接
k = krakenex.API(key=api_key, secret=api_secret)
kraken = KrakenAPI(k)


# 要取消的订单ID
order_id = "O7XOHH-J7YPR-U6QYYH"  # 替换为你要取消的实际订单ID

try:
    # 调用CancelOrder接口取消订单
    cancel_result = k.query_private('CancelOrder', {'txid': order_id})

    # 检查取消结果
    if cancel_result['error']:
        print(f"取消订单失败: {cancel_result['error']}")
    else:
        print(f"订单 {order_id} 取消成功。")
        print(f"取消订单的结果: {cancel_result['result']}")


except Exception as e:
    print(f"发生错误: {e}")

代码解释：

• 导入库： 导入 krakenex 和 pykrakenapi 库。
• API密钥： 将 YOUR_API_KEY 和 YOUR_API_SECRET 替换为你自己的Kraken API密钥和私钥。务必安全地保管你的API密钥。
• 创建API连接： 使用你的API密钥和私钥创建 krakenex.API 实例。然后使用这个实例来创建 KrakenAPI 实例。
• 订单ID： 将 "O7XOHH-J7YPR-U6QYYH" 替换为你要取消的实际订单ID。确保订单ID的准确性。
• 取消订单： 调用 k.query_private('CancelOrder', {'txid': order_id}) 来取消订单。 txid 参数指定了要取消的订单的ID。
• 错误处理： 检查 cancel_result['error'] 以确定取消是否成功。如果存在错误，则打印错误消息。
• 结果输出： 如果取消成功，则打印成功消息以及取消订单的详细结果。
• 异常处理： 使用 try...except 块来捕获可能发生的任何异常，并打印错误消息。

注意事项：

• API密钥安全： 确保你的API密钥安全，不要将其泄露给他人。
• 订单状态： 只能取消未成交或部分成交的订单。已完全成交的订单无法取消。
• 错误处理： 仔细检查API返回的错误信息，以便诊断取消失败的原因。常见的错误包括无效的订单ID、API密钥问题或网络连接问题。
• 交易所API文档： 参考交易所的API文档以获取关于 CancelOrder 接口的详细信息，例如参数要求、返回格式和错误代码。

以上示例展示了使用 krakenex 库取消Kraken交易所订单的基本步骤。不同的交易所可能使用不同的API接口和参数，因此请务必参考相应交易所的API文档进行操作。

初始化 Kraken API 客户端

与 Kraken 交易所进行交互的第一步是初始化 Kraken API 客户端。您需要安装 krakenex 库，这是一个 Python 封装器，简化了与 Kraken API 的通信。

k = krakenex.API()

此行代码创建了一个 Kraken API 客户端的实例。 现在您需要配置 API 密钥才能访问您的 Kraken 帐户并执行交易。请确保您已在 Kraken 交易所生成 API 密钥，并妥善保管。API 密钥通常包含一个 API 密钥和一个私有密钥。

k.load_key('kraken.key')

这行代码指示客户端从名为 'kraken.key' 的文件中加载您的 API 密钥和私有密钥。 重要提示： 不要直接在代码中硬编码您的 API 密钥和私有密钥。将它们存储在一个安全的文件中（例如 'kraken.key'），可以提高安全性。 'kraken.key' 文件的格式应为每行一个密钥，第一行为 API 密钥，第二行为私有密钥。 您也可以使用环境变量或其他安全方法来管理您的 API 密钥。 例如，您可以将密钥存储为环境变量，然后通过 os.environ 访问它们。 始终注意保护您的 API 密钥，避免泄露给他人，否则可能导致您的帐户被盗用。 您应定期检查并更新您的 API 密钥，以提高安全性。 您还应限制 API 密钥的权限，仅授予所需的权限，例如交易、提款或查询余额。 您可以在 Kraken 交易所的 API 管理界面中设置 API 密钥的权限。 使用 API 密钥时，请遵循 Kraken 交易所的 API 使用条款和限制。 过度使用 API 或违反使用条款可能导致您的 API 密钥被禁用。 建议您在实际交易前，先在 Kraken 的沙箱环境中测试您的 API 代码，以避免意外损失。

取消订单

取消 Kraken 交易所的挂单，需要使用 CancelOrder API 端点。以下代码展示了如何使用 krakenex Python 库来实现此功能。请确保你已经安装了 krakenex 库： pip install krakenex 。

准备工作：

• API 密钥： 你需要在 Kraken 交易所生成 API 密钥，并赋予其取消订单的权限。请妥善保管你的 API 密钥，避免泄露。
• krakenex 库： 确保已经安装 krakenex 库，该库简化了与 Kraken API 的交互。

请求参数（Request Parameters）：

CancelOrder API 需要传入订单 ID ( txid ) 作为参数。请将以下代码中的 O75IU-C4SFK-R55QDV 替换为你要取消的实际订单 ID。

params = {
     'txid': 'O75IU-C4SFK-R55QDV' # 替换为你的订单 ID
}

代码示例：

以下 Python 代码展示了如何使用 krakenex 库调用 CancelOrder API 并处理返回结果。

import krakenex

k = krakenex.API()
# 如果你有密钥文件，可以使用以下代码加载密钥：
# k.load_key('kraken.key')

try:
    result = k.query_private('CancelOrder', params)

    if result['error']:
        print(f"Error: {result['error']}")
    else:
        print(f"Order cancelled: {result['result']}")

except Exception as e:
    print(f"An error occurred: {e}")

代码解释：

• krakenex.API() ： 创建 Kraken API 客户端实例。 如果使用密钥文件，调用 k.load_key('kraken.key') 加载 API 密钥和私钥。
• k.query_private('CancelOrder', params) ： 调用 CancelOrder API， query_private 方法用于执行需要身份验证的私有 API 调用。
• result['error'] ： 检查返回结果中的 error 字段。如果该字段不为空，则表示 API 调用失败。
• result['result'] ： 如果 API 调用成功，订单取消信息将包含在 result 字段中。
• 异常处理： 使用 try...except 块捕获可能发生的异常，例如网络连接错误或无效的 API 密钥。

错误处理：

CancelOrder API 可能返回以下错误：

• EOrder:Invalid order ： 订单 ID 无效。
• EOrder:OrderStatus ： 订单状态不允许取消（例如，订单已成交或已被取消）。
• EGeneral:Invalid arguments ： 传入了无效的参数。

请务必根据返回的错误信息进行相应的处理。

重要提示：

• API 限制： Kraken 交易所对 API 调用频率有限制。请参考 Kraken API 文档，了解具体的限制和最佳实践，避免触发速率限制。
• 安全： 请务必妥善保管你的 API 密钥，避免泄露。不要将 API 密钥硬编码到代码中，建议使用环境变量或配置文件来存储 API 密钥。
• 测试： 在实际交易之前，建议使用 Kraken 的测试网 (Sandbox) 进行测试，以确保你的代码能够正常工作。