Kraken API 终极指南：新手也能轻松驾驭？

Kraken API 接口使用教程

Kraken 是一家知名的加密货币交易所，提供强大的 API 接口，允许开发者访问其市场数据、管理账户以及进行交易。本文将深入探讨 Kraken API 接口的使用方法，涵盖各个方面，帮助你快速上手。

1. API 密钥的获取与配置

在使用 Kraken API 之前，必须生成 API 密钥。API 密钥是访问 Kraken 平台各种功能的核心凭证，务必妥善保管。

• 登录 Kraken 账户： 你必须拥有一个经过验证的 Kraken 账户。这意味着你需要完成 Kraken 要求的 KYC（了解你的客户）验证流程，以确保符合监管要求并激活账户的全部功能。
• 访问 API 设置页面： 成功登录 Kraken 账户后，导航至账户设置区域。在账户设置中，寻找与“API”、“API 管理”或类似名称相关的选项。该页面是创建和管理 API 密钥的中心位置。
• 创建 API 密钥： 点击“生成新密钥”、“创建密钥”或类似的按钮，开始创建新的 API 密钥。系统会提示你为密钥设置描述信息，以便日后识别和管理。同时，你需要为该密钥选择必要的权限。权限设置至关重要，直接决定了该密钥可以访问哪些 Kraken API 功能。请务必根据你的具体需求仔细选择权限，避免授予不必要的权限，以降低安全风险。常见的权限包括：
  • Trade : 允许使用该密钥进行交易操作，包括下单、修改订单和取消订单等。该权限非常敏感，请谨慎使用。
  • Balance : 允许使用该密钥查询账户余额，包括各种加密货币和法币的持有数量。
  • Orders : 允许使用该密钥查询订单信息，包括当前挂单、历史订单以及订单状态等。
  • Funds : 允许使用该密钥进行资金转移操作，例如从现货钱包转移到期货钱包，或者提取资金。请务必谨慎使用该权限，并严格控制可以转移的金额和目标地址。
  • QueryLedgers : 允许使用该密钥查询账本信息，包括交易记录、充值记录和提现记录等。
  • QueryTrades : 允许使用该密钥查询交易历史，包括成交价格、成交数量和交易时间等。
  • Websocket : 允许使用该密钥连接 Kraken 的 Websocket API，实时获取市场数据和账户信息。

务必遵循最小权限原则，只赋予 API 密钥所需的最小权限，以确保账户安全。

保存 API 密钥： 生成密钥后，你会得到两个关键信息：

• API Key: 公钥，用于标识你的身份。
• Private Key: 私钥，用于签名你的请求。

请务必妥善保存私钥，不要泄露给任何人。私钥丢失可能导致你的账户被盗用。

配置环境变量： 为了方便在代码中使用 API 密钥，建议将其配置为环境变量。例如，在 Linux/macOS 系统中，你可以编辑 .bashrc 或 .zshrc 文件，添加以下内容：

bash export KRAKENAPIKEY="你的API Key" export KRAKENPRIVATEKEY="你的Private Key"

然后执行 source ~/.bashrc 或 source ~/.zshrc 使环境变量生效。

2. API 端点概览

Kraken API 提供了丰富的端点，旨在满足开发者和交易者对市场数据访问、账户管理和交易执行的各种需求。这些端点分为公共端点和私有端点，分别提供不同的功能。

• 公共端点（Public Endpoints）： 无需 API 密钥即可访问，主要用于获取实时或历史市场数据。这些端点允许开发者无需身份验证即可集成 Kraken 的市场信息，适用于行情展示、数据分析等场景。
  • /0/public/Time : 获取 Kraken 服务器的当前时间，以 Unix 时间戳格式返回。该端点可用于同步客户端时间和验证 API 连接。
  • /0/public/Assets : 获取 Kraken 上可用的所有资产信息，包括资产名称、最小交易单位、资产状态等。该信息对于构建动态交易界面和验证交易参数至关重要。
  • /0/public/AssetPairs : 获取 Kraken 上可用的所有交易对信息，包括交易对名称、交易对状态、价格精度、交易量精度、费用等级等。该信息对于构建交易系统和了解交易规则必不可少。
  • /0/public/Ticker : 获取指定交易对的实时市场行情，包括最新成交价、最高价、最低价、成交量、成交笔数、买一价、卖一价等。该端点是获取实时市场数据的核心。
  • /0/public/OHLC : 获取指定交易对的 OHLC (Open, High, Low, Close) 数据，即开盘价、最高价、最低价、收盘价，以及成交量。可以指定时间间隔，例如 1 分钟、5 分钟、1 小时等。该数据对于技术分析和图表绘制非常有用。
  • /0/public/Depth : 获取指定交易对的订单簿深度，即买单和卖单的挂单价格和数量。可以指定深度级别，例如 10 档、20 档等。该端点可以帮助了解市场流动性和价格压力。
  • /0/public/Trades : 获取指定交易对的最新成交记录，包括成交价格、成交数量、成交时间和买卖方向。该端点可以用于跟踪市场成交情况和识别交易趋势。
  • /0/public/Spread : 获取指定交易对的买卖价差，即最高买入价和最低卖出价之间的差值。该端点可以反映市场的流动性情况。
• 私有端点（Private Endpoints）： 需要 API 密钥进行身份验证，用于管理账户、进行交易和查询私有信息。使用私有端点前，必须生成 API 密钥，并妥善保管，防止泄露。API 密钥的权限应当根据实际需要进行配置，避免不必要的风险。
  • /0/private/Balance : 获取账户余额，包括各种资产的可用余额和总余额。该端点是管理账户资产的核心。
  • /0/private/TradeBalance : 获取交易余额，即用于交易的可支配余额。该余额可能与账户余额不同，因为它可能受到未结算订单的影响。
  • /0/private/OpenOrders : 获取所有未成交订单的信息，包括订单类型、订单价格、订单数量、订单状态等。该端点可以用于监控和管理未成交订单。
  • /0/private/ClosedOrders : 获取所有已成交订单的信息，包括订单类型、订单价格、订单数量、成交价格、成交时间等。该端点可以用于查询历史交易记录。
  • /0/private/QueryOrders : 查询指定订单的信息，可以通过订单 ID 查询。该端点可以用于精确查找特定订单的详细信息。
  • /0/private/TradesHistory : 获取交易历史，可以指定起始时间和结束时间。该端点可以用于查询一段时间内的交易记录。
  • /0/private/QueryTrades : 查询指定交易的信息，可以通过交易 ID 查询。该端点可以用于精确查找特定交易的详细信息。
  • /0/private/Ledgers : 获取账本记录，包括充值、提现、交易等所有资金变动记录。可以指定起始时间和结束时间。
  • /0/private/QueryLedgers : 查询指定账本记录的信息，可以通过账本 ID 查询。该端点可以用于精确查找特定账本记录的详细信息。
  • /0/private/AddOrder : 下单，可以指定交易对、订单类型（市价单、限价单等）、买卖方向、订单数量、订单价格等参数。该端点是进行交易的核心。
  • /0/private/CancelOrder : 撤单，可以通过订单 ID 撤销未成交订单。
  • /0/private/CancelAll : 撤销所有未成交订单。
  • /0/private/CancelAllOrdersAfter : 撤销指定时间后的所有订单。该端点可以用于风险控制，防止意外损失。
  • /0/private/DepositMethods : 获取可用的充值方式，例如银行转账、加密货币转账等。
  • /0/private/DepositAddresses : 获取指定资产的充值地址。
  • /0/private/DepositStatus : 获取充值状态，可以查询充值是否成功。
  • /0/private/WithdrawInfo : 获取提现信息，包括手续费等。
  • /0/private/Withdraw : 提现，可以指定资产、提现数量、提现地址等参数。
  • /0/private/WithdrawStatus : 获取提现状态，可以查询提现是否成功。
  • /0/private/WithdrawCancel : 取消提现。

3. 使用 Python 调用 Kraken API

以下是一个使用 Python 调用 Kraken API 的示例代码，展示了如何安全地获取账户余额。此示例侧重于演示 API 调用的基本流程，务必根据实际需求进行调整和完善。

import requests import hashlib import hmac import base64 import os import urllib.parse import urllib.request import

此段代码导入了必要的 Python 库： requests 用于发送 HTTP 请求， hashlib 用于哈希计算， hmac 用于生成 HMAC 签名， base64 用于 Base64 编码， os 用于访问环境变量， urllib.parse 用于 URL 编码， urllib.request 用于发起HTTP请求， 用于处理JSON数据。

def kraken_request(uri_path, data, api_key, api_sec): api_url = "https://api.kraken.com" api_version = "0" url = api_url + '/' + api_version + uri_path

此函数定义了与 Kraken API 交互的核心逻辑。 uri_path 是 API 端点路径， data 是请求参数， api_key 和 api_sec 分别是你的 API 密钥和私钥。

首先构建API的完整URL。

data = data or {}

headers = {}

headers['API-Key'] = api_key

postdata = urllib.parse.urlencode(data)

encoded = (str(data['nonce']).encode('utf-8') + postdata.encode('utf-8'))
message = uri_path.encode('utf-8') + hashlib.sha256(encoded).digest()
signature = hmac.new(base64.b64decode(api_sec),
                         message, hashlib.sha512)
headers['API-Sign'] = base64.b64encode(signature.digest()).decode()

req = urllib.request.Request(url, data=postdata.encode('utf-8'), headers=headers)
response = urllib.request.urlopen(req)
return .loads(response.read().decode('utf-8'))

这段代码构建请求头和请求体，并对请求进行签名。 nonce 是一个唯一的随机数，用于防止重放攻击。 API-Sign 是使用私钥对请求进行 HMAC-SHA512 签名后的 Base64 编码。为了数据安全，请务必对请求进行签名。

urllib.parse.urlencode(data) 将 data 字典编码为URL查询字符串。

使用 hashlib.sha256 对 encoded 数据进行SHA256哈希运算,确保数据的完整性。

hmac.new 函数使用私钥和哈希后的消息创建HMAC对象，确保请求的真实性。

base64.b64encode 将签名进行Base64编码，方便在HTTP头部传输。

使用 urllib.request 发送带有签名信息的POST请求，并解析返回的JSON数据。

api_key = os.environ.get('KRAKEN_API_KEY') api_sec = os.environ.get('KRAKEN_PRIVATE_KEY')

这部分代码从环境变量中获取 API 密钥和私钥。强烈建议不要将 API 密钥直接硬编码在代码中，而是使用环境变量或其他安全的方式进行存储。

确保 API 密钥和密钥已设置

为了安全地访问 Kraken 交易所的 API，必须配置 API 密钥和私有密钥。这些密钥用于身份验证和授权，允许您的应用程序代表您执行交易和其他操作。

以下代码段检查是否已设置 api_key 和 api_sec 变量。如果任何一个变量为空，则会引发 ValueError 异常，并显示一条信息性错误消息。

if not api_key or not api_sec:
    raise ValueError("KRAKEN_API_KEY and KRAKEN_PRIVATE_KEY 环境变量必须设置。")

请务必将 KRAKEN_API_KEY 和 KRAKEN_PRIVATE_KEY 环境变量设置为您的实际 API 密钥和私有密钥。这些密钥应安全存储，并避免公开暴露，例如在版本控制系统中提交。

API 密钥和私有密钥的安全性至关重要。如果密钥泄露，攻击者可能会访问您的 Kraken 帐户并执行未经授权的交易。因此，请采取必要的预防措施来保护您的密钥。

建议使用环境变量来存储 API 密钥和私有密钥，因为它们可以更容易地管理和保护。环境变量可以设置为在操作系统级别或应用程序级别可用。使用环境变量可以避免将密钥硬编码到您的应用程序中，从而降低了密钥泄露的风险。

在 Python 中，可以使用 os.environ 访问环境变量。例如，可以使用以下代码检索 KRAKEN_API_KEY 环境变量：

import os

api_key = os.environ.get("KRAKEN_API_KEY")

确保在您的应用程序中正确处理 API 密钥和私有密钥，以防止安全漏洞并保护您的 Kraken 帐户。

生成唯一nonce（一次性随机数）

Nonce（一次性随机数）是加密通信中至关重要的组成部分，主要用于防止重放攻击。重放攻击是指攻击者截获并重复发送已授权的交易或请求，从而在未经授权的情况下执行恶意操作。通过为每个交易或请求生成唯一的nonce，可以有效防止此类攻击。

生成方法：

nonce = str(int(time.time() * 1000)) # 使用毫秒级时间戳

以上代码片段展示了一种常见的nonce生成方法，即使用当前时间的毫秒级时间戳。 time.time() 函数返回自 epoch（1970 年 1 月 1 日 00:00:00 UTC）以来的秒数。将其乘以 1000 可以得到毫秒级的时间戳，从而提高nonce的唯一性。 int() 函数将时间戳转换为整数， str() 函数将其转换为字符串，以便于后续使用。

安全性考虑：

虽然使用时间戳是一种简单便捷的nonce生成方法，但在高并发环境下，可能会出现nonce重复的可能性。为了进一步增强安全性，可以考虑以下方法：

• 结合随机数： 将时间戳与一个随机数结合起来，可以显著提高nonce的唯一性。例如，可以使用Python的 random 模块生成一个随机数，并将其附加到时间戳上。
• 使用UUID： UUID（通用唯一识别码）是一种标准的生成唯一标识符的方法。Python的 uuid 模块提供了生成UUID的函数，可以保证在分布式系统中的唯一性。
• 递增计数器： 使用一个递增的计数器作为nonce，并将其存储在安全的地方。每次生成nonce时，将计数器加1。这种方法可以保证nonce的唯一性，但需要注意计数器的安全性，防止被篡改。

选择合适的nonce生成方法需要根据具体的应用场景和安全需求进行权衡。在高安全性要求的场景下，建议采用结合随机数或使用UUID的方法。

API 请求的数据

构建 API 请求时，数据部分至关重要。它包含了服务器理解和处理请求所需的关键信息。以下是一个基础数据结构的示例，着重强调了 "nonce" 字段的重要性。

data = {
"nonce": nonce
}

Nonce (一次性随机数) 的详细说明：

“Nonce” 是 "number used once" 的缩写，它是一个在密码学中被用于避免重放攻击的关键元素。在 API 请求的上下文中，nonce 是一个唯一的、仅使用一次的随机或伪随机数。每次发起 API 请求时，都应该生成一个新的 nonce 值。

Nonce 的作用：

• 防止重放攻击： 重放攻击是指攻击者截获并重新发送合法的 API 请求。通过使用 nonce，服务器可以验证请求的新鲜度。如果服务器接收到具有相同 nonce 值的请求，它会将其识别为潜在的重放攻击并拒绝该请求。
• 确保请求的唯一性： Nonce 确保即使请求的内容相同，每次请求也被视为唯一的。这对于需要精确跟踪和避免重复操作的场景至关重要，例如交易处理。

生成 Nonce 的方法：

有多种方法可以生成 nonce。常用的方法包括：

• 时间戳： 使用当前时间戳（例如，自 Unix 纪元以来的毫秒数）作为 nonce。为了避免冲突，可以结合其他随机数据。
• 随机数生成器： 使用加密安全的随机数生成器生成一个随机数。确保随机数具有足够的长度（例如，128 位或更高）以防止碰撞。
• 计数器： 使用一个递增的计数器作为 nonce。需要仔细管理计数器以避免重置和重复使用 nonce。

实现注意事项：

• 服务器端验证： 服务器必须记录已经使用过的 nonce 值，以便检测重放攻击。可以设置一个时间窗口，在此窗口内服务器会跟踪所有 nonce 值。超出时间窗口的 nonce 值可以被清除。
• 防止时钟偏差： 如果使用时间戳作为 nonce，需要考虑客户端和服务器之间的时钟偏差。允许一个合理的时间偏差范围，以避免因轻微的时钟不同步而拒绝有效的请求。
• 安全性： 确保使用的随机数生成器是加密安全的，并且 nonce 值具有足够的长度，以防止攻击者预测或伪造 nonce。

除了 nonce 之外， data 对象还可以包含其他必要的参数，例如 API 密钥、交易详情、用户身份验证信息等。这些参数的具体内容取决于 API 的具体要求和功能。

调用API获取账户余额

为了获取您的账户余额，您需要调用交易所提供的私有API端点。以下代码演示了如何使用Kraken交易所的API来查询余额。请务必替换 api_key 和 api_sec 为您的真实API密钥和私钥，并妥善保管这些信息，避免泄露。

try 语句块用于尝试执行API调用，并处理可能发生的异常情况。 kraken_request 函数负责构建请求并发送到Kraken服务器。 '/0/private/Balance' 是Kraken API的余额查询端点。 data 参数用于传递任何需要的额外参数，在本例中通常为空。 api_key 和 api_sec 分别是您的API密钥和私钥，用于对请求进行身份验证。

try:
    balance = kraken_request('/0/private/Balance', data, api_key, api_sec)

kraken_request 函数需要根据交易所的具体API规范实现，通常包括以下步骤：

• 构造HTTP请求头，包含API密钥和签名。
• 使用HMAC-SHA512算法对请求进行签名，以确保请求的完整性和真实性。
• 发送HTTP POST请求到指定的API端点。
• 解析API返回的JSON响应。

# 打印账户余额
import 
print(.dumps(balance, indent=4))

.dumps(balance, indent=4) 将API返回的 balance 对象格式化为JSON字符串，并使用4个空格进行缩进，使其更易于阅读。 如果API调用成功， 您将在控制台中看到包含您的账户余额信息的JSON输出。

except 语句块用于捕获可能发生的异常。例如，网络连接错误、API密钥无效、权限不足等。如果发生异常，程序将执行 except 语句块中的代码，打印错误信息，从而避免程序崩溃。

except Exception as e:
    print(f"Error: {e}")

f"Error: {e}" 使用f-string格式化字符串，将错误信息 e 插入到字符串中。 这有助于您快速诊断API调用失败的原因。

为了安全起见，建议将API密钥和私钥存储在环境变量中，而不是直接硬编码在代码中。 请仔细阅读交易所的API文档，了解API的使用限制和最佳实践。

代码解释：

1. 导入库： 导入 requests 库，这是一个强大的 Python 库，专门用于发送各种类型的 HTTP 请求，例如 GET、POST、PUT、DELETE 等。它简化了与 Web 服务器的交互过程，使得发送请求和处理响应变得更加容易。
2. 设置 API 密钥： 从环境变量中安全地获取 API Key 和 Private Key。环境变量是一种存储敏感信息的常用方法，避免将密钥直接硬编码在代码中，降低了泄露风险。API Key 用于标识你的身份，Private Key 用于对请求进行签名，确保请求的安全性。推荐使用操作系统级别的环境变量或专门的密钥管理工具进行存储。
3. 构建请求头： 创建包含 API Key 和 API Sign 的请求头。请求头是 HTTP 请求的重要组成部分，用于传递额外的元数据信息。API Key 在请求头中用于身份验证，而 API Sign 则是使用 Private Key 对请求数据进行加密签名后的结果，用于验证请求的完整性和真实性，防止请求被篡改或伪造。常见的签名算法包括 HMAC (Hash-based Message Authentication Code) 算法，结合 SHA256 等哈希函数。
4. 发送 POST 请求： 使用 requests.post() 方法向 Kraken API 发送 POST 请求。POST 请求常用于向服务器提交数据，例如创建订单、执行交易等。传递 API 端点 URL、构造好的请求头 (headers) 和需要提交的请求数据 (data)。请求数据通常以 JSON 格式进行序列化，便于服务器解析。
5. 处理响应： 从服务器返回的响应中获取 JSON 数据。JSON (JavaScript Object Notation) 是一种轻量级的数据交换格式，易于阅读和解析。通过 response.() 方法将响应内容解析为 Python 字典或列表，方便后续操作。获取账户余额只是一个示例，实际上可以根据 API 的不同，获取交易历史、订单状态等各种信息。务必进行错误处理，检查响应状态码，并处理可能出现的异常情况，例如网络错误、API 错误等。

注意：

• API 密钥替换： 请务必将代码中的占位符 YOUR_API_KEY 和 YOUR_PRIVATE_KEY 替换为你真实的 Kraken API 密钥。API 密钥包括公钥（API Key）和私钥（Private Key），它们用于验证你的身份并授权你访问 Kraken 交易所的 API 服务。未正确配置密钥会导致 API 调用失败，并可能暴露你的账户信息。请从 Kraken 交易所的官方网站或开发者平台获取你的 API 密钥，并妥善保管私钥。
• 代码示例与定制： 以上提供的代码片段仅为演示如何使用 Kraken API 的基本示例。在实际应用中，你需要根据你的具体需求修改代码。 例如，你可以调用不同的 API 端点以获取不同的数据，如交易历史、账户余额、市场深度等。你还需要根据 API 返回的数据格式，编写相应的代码来解析和处理数据。你可以参考 Kraken 官方 API 文档，了解更多 API 端点、参数和返回数据格式的信息。
• JSON 数据解析： Kraken API 接口返回的数据格式为 JSON（JavaScript Object Notation），这是一种常用的数据交换格式。Python 的 库提供了方便的工具来解析 JSON 数据。你可以使用 .loads() 函数将 JSON 字符串转换为 Python 字典或列表，然后通过键值对的方式访问数据。例如，如果你想获取订单簿中的买单价格，你可以先解析 JSON 数据，然后通过相应的键来获取买单列表，并提取价格信息。确保你已经安装了 库。

4. 订单类型与参数

Kraken API 支持多种订单类型，交易者可以根据自身交易策略和风险偏好选择合适的订单类型。以下详细介绍 Kraken API 支持的常见订单类型，并列出关键参数：

• 市价单（Market Order）： 以当前市场最佳可用价格立即成交的订单。市价单执行迅速，但成交价格可能与预期略有偏差，尤其是在市场波动剧烈时。
  • type : buy (买入) 或 sell (卖出)
  • ordertype : market
  • pair : 交易对，例如 XXBTZUSD (比特币/美元)。 务必使用 Kraken 交易所支持的正确交易对代码。
  • volume : 交易数量，以交易对的基础货币为单位。 例如，购买 1 个比特币，则 volume 值为 1。
• 限价单（Limit Order）： 以指定价格或更优价格成交的订单。 如果市场价格未达到指定价格，则订单将保持挂单状态，直到成交或被取消。
  • type : buy 或 sell
  • ordertype : limit
  • pair : 交易对，例如 XXBTZUSD
  • volume : 交易数量
  • price : 期望的成交价格。 买入订单的 price 为最高买入价，卖出订单的 price 为最低卖出价。
• 止损单（Stop Loss Order）： 当市场价格达到指定的止损价格时，立即以市价成交的订单。 止损单用于限制潜在损失。
  • type : buy 或 sell
  • ordertype : stop-loss
  • pair : 交易对，例如 XXBTZUSD
  • volume : 交易数量
  • price : 止损价格。 当市场价格达到或超过此价格时，订单将被触发。
• 止损限价单（Stop Loss Limit Order）： 当市场价格达到指定的止损价格时，以指定限价成交的订单。 这种订单类型结合了止损单和限价单的特性。
  • type : buy 或 sell
  • ordertype : stop-loss-limit
  • pair : 交易对，例如 XXBTZUSD
  • volume : 交易数量
  • price : 止损价格。 当市场价格达到或超过此价格时，会触发一个限价订单。
  • price2 : 限价。 触发后，将以该价格或更优价格提交限价订单。
• 止盈单（Take Profit Order）： 当市场价格达到指定的止盈价格时，立即以市价成交的订单。 止盈单用于锁定利润。
  • type : buy 或 sell
  • ordertype : take-profit
  • pair : 交易对，例如 XXBTZUSD
  • volume : 交易数量
  • price : 止盈价格。 当市场价格达到或超过此价格时，订单将被触发。
• 止盈限价单（Take Profit Limit Order）： 当市场价格达到指定的止盈价格时，以指定限价成交的订单。
  • type : buy 或 sell
  • ordertype : take-profit-limit
  • pair : 交易对，例如 XXBTZUSD
  • volume : 交易数量
  • price : 止盈价格。 当市场价格达到或超过此价格时，会触发一个限价订单。
  • price2 : 限价。 触发后，将以该价格或更优价格提交限价订单。
• 追踪止损单（Trailing Stop Order）： 跟随市场价格移动的止损单。 止损价格会随着市场价格的上涨而向上调整（对于买入订单）或随着市场价格的下跌而向下调整（对于卖出订单），从而锁定利润并限制潜在损失。
  • type : buy 或 sell
  • ordertype : trailing-stop
  • pair : 交易对，例如 XXBTZUSD
  • volume : 交易数量
  • trailing_stop : 追踪距离。 止损价格与市场价格之间的价差。 例如，如果 trailing_stop 设置为 10，则止损价格将始终比当前市场价格低 10（对于卖出订单）。
• 追踪止损限价单（Trailing Stop Limit Order）： 跟随市场价格移动的止损限价单。 结合了追踪止损和限价单的特性。
  • type : buy 或 sell
  • ordertype : trailing-stop-limit
  • pair : 交易对，例如 XXBTZUSD
  • volume : 交易数量
  • trailing_stop : 追踪距离。 止损价格与市场价格之间的价差。
  • price2 : 限价。 触发后，将以该价格或更优价格提交限价订单。

其他常用参数：

• leverage : 杠杆倍数。指定交易的杠杆比例，允许交易者以较小的保证金控制更大的仓位。 例如，如果杠杆设置为10x，则交易者只需投入交易价值的1/10作为保证金。 高杠杆可以放大收益，但也会相应地放大损失，务必谨慎使用。
• close[ordertype] : 平仓订单类型。定义平仓时使用的订单类型。 常用的订单类型包括 "market" (市价单，立即以当前市场价格成交) 和 "limit" (限价单，只有当市场价格达到指定价格时才成交)。 根据交易策略和市场状况选择合适的订单类型。
• close[price] : 平仓价格。 当使用限价单平仓时，指定期望的平仓价格。 只有当市场价格达到或超过此价格时，订单才会执行。 设置合理的平仓价格是风险管理的关键部分。
• close[price2] : 平仓价格2。 部分交易平台支持设置第二个平仓价格，作为备选或补充。 具体的含义和用法取决于平台的功能和设置。 例如，可能用于设置止损价格或在特定情况下触发平仓。
• expiretm : 订单过期时间。 设置订单的有效期限。 如果在指定的时间之前订单未成交，系统将自动取消订单。 这可以避免长期挂单占用资金，并提高交易效率。 时间通常以时间戳或相对时间表示，具体格式取决于交易平台的规定。

5. 错误处理

调用 Kraken API 时，应用程序可能会遭遇各种错误情况。Kraken API 在发生错误时，会返回一个包含 error 字段的 JSON 响应体，该字段详细描述了错误信息。为了确保应用程序的稳定性和可靠性，开发者需要认真检查返回的 error 字段，准确理解错误的具体原因，并根据错误类型采取适当的处理措施。

常见的错误类型包括：

• EAPI:Invalid key : 此错误表明提供的 API 密钥无效或已过期。请检查 API 密钥是否正确配置，并确保其未被禁用。若密钥已过期，请重新生成新的 API 密钥。
• EAPI:Rate limit exceeded : 当应用程序在短时间内发送过多的 API 请求时，就会触发此错误。Kraken API 对请求频率有限制，以防止滥用。开发者应实施速率限制策略，例如使用队列或延迟函数，以避免超过 API 速率限制。同时，查阅Kraken API文档了解具体的速率限制规则。
• EOrder:Insufficient funds : 在尝试下单时，如果账户余额不足以支付订单金额，则会返回此错误。在下单之前，务必检查账户余额是否充足。 可以通过查询账户余额 API 来获取最新的账户信息。
• EOrder:Order minimum not met : Kraken 对不同交易对设置了最小订单数量限制。如果订单数量低于该限制，则会返回此错误。请参考 Kraken API 文档或交易所界面，了解特定交易对的最小订单数量要求，并确保订单数量满足要求。
• EGeneral:Internal error : 此错误通常表示 Kraken 服务器内部出现了问题。这可能是由于服务器过载、维护或其他未知原因引起的。遇到此类错误时，建议稍后重试该请求。如果错误持续发生，请联系 Kraken 技术支持寻求帮助。

处理错误的建议：

• 仔细阅读错误信息： Kraken API 的错误信息设计详尽，通常能提供关于错误性质和位置的明确线索。仔细分析错误代码和相关的描述性文本，例如 `EAPI:Invalid nonce` 或 `EOrder:Insufficient funds`，可以帮你迅速诊断问题根源，节省调试时间。了解常见的错误代码及其含义是高效解决问题的关键。
• 检查 API 密钥： 验证你使用的 API 密钥是否与你在 Kraken 交易所账户中生成的密钥完全一致，包括大小写。确认密钥已启用并且未过期。更重要的是，检查密钥权限设置，确保它拥有执行你所尝试操作（如交易、查询余额等）所需的全部权限。例如，只读权限的密钥无法用于下单交易。
• 控制 API 调用频率： Kraken API 对调用频率有限制，以防止滥用并保证系统稳定性。短时间内发送过多的请求会导致 API 返回错误，如 `Rate limit exceeded`。实施重试机制，并使用指数退避算法，逐步增加重试之间的间隔时间。考虑使用 Kraken 提供的 WebSocket API 进行实时数据流传输，这通常比频繁轮询 REST API 更有效率。
• 检查订单参数： 在提交订单之前，务必仔细检查订单参数，确保其符合 Kraken 的规范。核实交易对（例如 `XXBTZEUR`）是否正确，买卖方向（`buy` 或 `sell`）是否明确，订单类型（`market`、`limit`、`stop-loss` 等）是否适用，以及数量和价格是否合理且在允许的范围内。确保数量精度符合交易对的要求。
• 处理服务器内部错误： 当 Kraken 服务器遇到内部错误时，API 可能会返回 `Internal Server Error` 或类似的状态码。这些错误通常是临时的，表明服务器正在经历问题。在这种情况下，避免立即重试，而是稍等一段时间（例如几秒或几分钟），然后再次尝试。实施重试逻辑可以提高应用程序的健壮性。同时，关注 Kraken 官方的维护公告，了解是否存在计划内的维护活动。

6. Websocket API

除了 REST API，Kraken 还提供了强大的 Websocket API，用于实时获取精细的市场数据和账户信息。 Websocket API 相较于 REST API 的显著优势在于其极低的延迟和卓越的效率，使其成为对实时性有严苛要求的应用程序和交易策略的理想选择。通过 Websocket，用户可以避免频繁轮询 REST API 造成的资源浪费和延迟，从而更快地响应市场变化。

Websocket API 的使用方法相较于 REST API 更为复杂，需要借助专门的 Websocket 客户端库来建立和维护连接。 用户需要首先连接到 Kraken 提供的 Websocket 服务器端点，然后根据自身需求订阅特定的数据频道。这些频道涵盖了各种市场数据，例如实时交易价格、订单簿更新、深度数据以及账户余额变动等。 成功订阅后，服务器会主动将最新的数据推送给客户端，无需客户端主动请求，从而实现了近乎实时的信息同步。

开发者需要仔细研究 Kraken 提供的 Websocket API 文档，了解各种频道的订阅方式、数据格式以及错误处理机制。 为了保证连接的稳定性和可靠性，还需要考虑心跳机制、断线重连策略等因素。 熟练掌握 Websocket API 的使用，将能够为用户带来更高效、更实时的交易体验。

7. 其他注意事项

• API 调用频率限制： Kraken API 为了保障服务器稳定性和公平性，对所有用户的 API 调用频率都设置了限制。务必在你的应用程序中实现合理的频率控制机制，例如使用延迟或队列。详细的频率限制规则可以在 Kraken 的官方 API 文档中找到，不同的 API 端点可能具有不同的限制。超出 API 调用频率限制可能会导致你的 API 密钥被暂时或永久禁用，具体取决于违规的严重程度。请务必仔细阅读并遵守 Kraken 的 API 使用条款。
• 账户安全： API 密钥是访问 Kraken 账户的重要凭证，必须像对待银行密码一样妥善保管。切勿将 API 密钥泄露给任何第三方，也不要将其存储在不安全的地方，例如公共代码仓库或未经加密的配置文件中。强烈建议定期更换 API 密钥，以降低密钥泄露的风险。开启双重验证（2FA）可以进一步提高账户的安全性。 Kraken 可能提供 IP 地址白名单功能，限制 API 密钥只能从特定的 IP 地址访问，这也是一种有效的安全措施。
• API 版本： Kraken API 会不断迭代更新，以提供更强大的功能和更好的性能。你需要密切关注 Kraken 官方发布的 API 更新公告，了解最新的 API 版本信息。及时更新你的代码以适应新的 API 版本，可以避免因使用过时的 API 而导致的问题。旧版本的 API 可能会被弃用，不再提供支持。建议在开发过程中使用版本控制系统，以便于回滚和升级 API 版本。
• 官方文档： Kraken 提供了详尽且不断更新的 API 文档，其中包含了 API 端点、请求参数、响应格式、错误代码等详细信息。官方文档是学习和使用 Kraken API 的最佳资源。你应该经常参考官方文档，了解 API 的最新信息和使用方法。官方文档通常提供各种编程语言的示例代码，可以帮助你更快地掌握 API 的使用技巧。如果在使用 API 过程中遇到任何问题，首先应该查阅官方文档，寻找解决方案。

希望本文能够帮助你快速上手 Kraken API 接口的使用。在实际应用中，请务必仔细阅读 Kraken 的 API 使用条款和风险提示，谨慎操作，确保账户安全和资金安全。