rQFZdv...
Kraken API 接口使用指南：从入门到精通
1. 简介
Kraken 是一家全球领先且备受信赖的加密货币交易所，以其丰富的交易对选择、高流动性和强大的安全措施而闻名。Kraken 提供了广泛的加密货币交易品种，包括比特币（BTC）、以太坊（ETH）、莱特币（LTC）以及众多其他数字资产。除了用户友好的 Web 界面，Kraken 还提供了一个功能强大的应用程序编程接口（API），允许开发者通过程序化方式与交易所进行交互。该 API 提供了广泛的功能，包括：
- 市场数据获取： 实时获取各种交易对的最新价格、交易量、深度图以及历史交易数据。
- 交易执行： 创建、修改和取消各种类型的订单，例如市价单、限价单和止损单。
- 账户管理： 查询账户余额、交易历史、订单状态以及进行资金充提操作。
本文将深入探讨 Kraken API 的使用方法，旨在帮助读者从入门到精通，逐步掌握利用 API 进行自动化交易和数据分析的技巧。我们将详细介绍 API 的认证机制、常用接口的使用以及常见问题的解决方法。无论您是量化交易员、算法交易爱好者还是希望构建自己的加密货币交易应用程序，本文都将为您提供有价值的指导。
2. API 密钥生成与管理
使用 Kraken API 的首要步骤是生成 API 密钥。用户需登录 Kraken 账户，导航至“安全”选项卡，找到并进入“API”部分。
-
密钥权限：
创建 API 密钥时，必须极其谨慎地选择所需的权限。为了最大程度地保障账户安全，权限范围应尽可能精简，仅授予应用程序执行其功能所必需的最低权限。常见的权限及其详细说明包括：
- Trade： 允许执行交易操作，例如创建、修改和取消订单。 这对于自动化交易策略至关重要。
- Funding： 允许执行资金操作，包括提现和充值。 请务必极其谨慎地授予此权限！ 授予此权限可能会带来严重的资金风险，仅在绝对必要时才应考虑。
- Query Funds： 允许查询账户余额，包括不同币种的可用余额和总余额。 这对于监控账户资产至关重要。
- Query Open Orders & Trades： 允许查询当前未成交的订单和历史交易记录。这对于分析交易策略的有效性至关重要。
- Query Ledger Entries： 允许查询账本记录，包括所有账户活动的详细记录，如交易、充值、提现、手续费等。这对于审计和税务报告至关重要。
- Query Trade Balance： 允许查询交易余额，即用于交易的资金余额。这与总账户余额不同，因为它可能不包括未用于交易的资金。
- Query Closed Orders & Trades： 允许查询已完成（已关闭）的订单和交易历史记录。这对于分析历史交易绩效至关重要。
- Query Deposits & Withdrawals： 允许查询充值和提现记录，包括时间、金额、币种以及交易状态。这对于跟踪资金流动至关重要。
- Query Key Information： 允许查询密钥信息，例如密钥的创建时间、权限列表以及 IP 地址限制。这对于密钥管理和审计至关重要。
- Nonce 窗口： Kraken API 利用 Nonce（一个单调递增的数字）来防御重放攻击，确保每个请求的唯一性。Nonce 窗口定义了 Kraken 服务器接受 Nonce 的有效时间范围，超出此范围的请求将被拒绝。强烈建议保持默认设置，通常足以满足大多数应用场景。
- IP 地址限制： 通过将 API 密钥绑定到特定的 IP 地址，可以显著增强安全性。如果你的应用程序运行在预定义的服务器或 IP 地址范围内，强烈建议设置此选项。只有来自授权 IP 地址的请求才会被接受，从而有效防止未经授权的访问。
- 密钥安全： 生成 API 密钥后，务必采取必要的安全措施进行妥善保管。切勿将密钥泄露给任何第三方，避免通过任何不安全的渠道传输密钥，也不要将密钥存储在公共或未加密的版本控制系统中。可以使用诸如加密存储、硬件安全模块（HSM）或密钥管理服务等安全机制来保护 API 密钥。定期轮换 API 密钥也是一种良好的安全实践。
3. API 端点与请求方式
Kraken API 提供一系列端点，分别服务于不同的功能需求。这些端点可以大致分为两类：公开端点和私有端点。
-
公开端点：
无需进行身份验证即可访问，主要用于获取实时的市场数据和公共信息，例如各种交易对的价格、交易量、订单簿深度等。这些端点对于构建行情显示应用、数据分析工具以及量化交易策略至关重要。
-
/0/public/Ticker: 获取特定交易对的行情数据快照，包含最新成交价、最高价、最低价、成交量、时间加权平均价(VWAP)等关键指标，帮助用户快速了解市场动态。 -
/0/public/Depth: 获取指定交易对的订单簿数据，提供买单和卖单的价格和数量信息，可以用于分析市场深度、评估流动性以及进行高级交易策略开发。可以通过调整参数来获取不同深度的订单簿数据。 -
/0/public/Trades: 获取指定交易对的最新交易记录，包含成交价格、成交数量、成交时间等信息，可以用于追踪市场动向、进行历史数据分析以及验证交易执行情况。 -
/0/public/OHLC: 获取指定交易对的 OHLC（开盘价、最高价、最低价、收盘价）数据，也称为K线数据。这些数据按照指定的时间周期（如分钟、小时、天）进行聚合，是技术分析的基础，可以用于识别趋势、支撑位和阻力位。 -
/0/public/Time: 获取 Kraken 服务器的当前时间，用于同步客户端时间，确保请求的时效性，尤其是在高频交易等对时间精度要求高的场景中。
-
-
私有端点：
访问需要进行身份验证，用于执行与用户账户相关的操作，包括进行交易、管理账户余额、查看交易历史等。安全地访问这些端点至关重要，需要妥善保管 API 密钥。
-
/0/private/Balance: 获取账户中各种币种的可用余额和总余额，是进行交易决策和风险管理的基础。 -
/0/private/TradeBalance: 获取交易余额，即用于交易的可用资金，与总余额的区别在于，交易余额可能会扣除已下单但未成交的订单所占用的资金。 -
/0/private/AddOrder: 下单，即创建新的买单或卖单。可以指定交易对、订单类型（市价单、限价单等）、订单数量、价格等参数。 -
/0/private/CancelOrder: 撤单，即取消尚未成交的订单。需要提供订单的ID。 -
/0/private/OpenOrders: 获取当前账户中所有未成交的订单列表，包含订单ID、交易对、订单类型、价格、数量等信息。 -
/0/private/ClosedOrders: 获取账户中已成交的订单历史记录，包含订单ID、交易对、成交价格、成交数量、成交时间、手续费等信息。 -
/0/private/TradesHistory: 获取更详细的交易历史记录，包括所有已成交的订单和交易事件，可以用于审计交易行为、计算盈亏等。 -
/0/private/Ledgers: 获取账户的账本记录，包含所有资金变动记录，例如充值、提现、交易、手续费等，可以用于财务管理和税务申报。 -
/0/private/DepositAddresses: 获取指定币种的充值地址，用于向 Kraken 账户充值资金。每次请求可能会生成新的充值地址，建议每次充值前都获取最新的地址。 -
/0/private/Withdraw: 提现，即从 Kraken 账户提取资金到指定的外部地址。需要提供币种、提现地址、提现数量等信息。
-
API 请求通常使用 HTTP POST 方法发送，并且在请求头中必须包含
API-Key
和
API-Sign
字段。
API-Key
是你的 API 密钥，用于标识你的身份。
API-Sign
是一个根据请求参数和你的私钥生成的签名，用于验证请求的完整性和真实性，防止篡改。生成签名需要使用 HMAC-SHA512 算法。
4. API 签名生成
为了保障私有端点的数据安全，所有发送到私有端点的 API 请求都必须经过签名认证。签名过程旨在验证请求的来源和完整性，防止恶意篡改或伪造请求。
-
构建 POST 数据：
将所有请求参数（包括 nonce，时间戳等）按照字母顺序排列，然后将它们构建成一个字符串。此步骤尤其需要注意数据类型和编码，确保所有参数都转换为字符串类型，并使用 UTF-8 编码。构建的字符串应为标准的 URL 查询字符串格式，例如：
param1=value1¶m2=value2。 - 计算 SHA256 哈希： 使用 SHA256 算法对上一步构建的 POST 数据字符串进行哈希计算。SHA256 是一种单向哈希函数，它将任意长度的数据映射为固定长度的哈希值。需要注意的是，输入到 SHA256 算法的数据必须是字节串（bytes），如果原始数据是字符串，需要先进行编码。
-
对请求路径和哈希值进行编码：
使用 UTF-8 编码 API 请求路径（例如：
/0/private/Balance），并将其与 SHA256 哈希值连接起来。此步骤确保了请求路径和请求数据的完整性被纳入到最终的签名计算中。 - 计算 HMAC-SHA512 哈希： 使用 HMAC-SHA512 算法，以 API 私钥（API Secret）作为密钥，对上一步编码后的请求路径和哈希值连接的字符串进行哈希计算。HMAC（Hash-based Message Authentication Code）是一种使用密钥的哈希函数，它提供了更高的安全性，可以防止密钥泄露情况下的攻击。API 私钥通常由交易所提供，必须妥善保管。
- 将 HMAC-SHA512 哈希值进行 Base64 编码： 将 HMAC-SHA512 哈希值的原始二进制数据进行 Base64 编码。Base64 是一种将二进制数据转换为 ASCII 字符串的编码方式，便于在网络上传输和存储。Base64 编码后的字符串就是最终生成的 API 签名，将其添加到请求头中，以便服务器进行验证。
以下是一个 Python 示例，展示了如何生成 Kraken 交易所的 API 签名。请注意，实际应用中需要根据交易所的具体 API 文档进行调整：
import hashlib
import hmac
import base64
import urllib.parse
def generate_kraken_signature(api_secret, api_path, api_post, nonce):
post_data = urllib.parse.urlencode(api_post)
encoded = (str(nonce) + post_data).encode()
message = api_path.encode() + hashlib.sha256(encoded).digest()
mac = hmac.new(base64.b64decode(api_secret), message, hashlib.sha512)
sigdigest = base64.b64encode(mac.digest())
return sigdigest.decode()
代码解释：
-
api_secret：您的 API 私钥，从交易所获取。 -
api_path：API 请求的路径，例如/0/private/Balance。 -
api_post：一个字典，包含了所有 POST 请求的参数。 -
nonce：一个唯一的随机数或时间戳，用于防止重放攻击。每次请求都应该生成一个新的 nonce。 -
urllib.parse.urlencode(api_post)：将字典形式的 POST 数据转换为 URL 编码的字符串。 -
(str(nonce) + post_data).encode()：将 nonce 和 POST 数据连接起来，并进行 UTF-8 编码。 -
api_path.encode() + hashlib.sha256(encoded).digest()：将 API 路径编码后与 SHA256 哈希值连接。 -
hmac.new(base64.b64decode(api_secret), message, hashlib.sha512)：使用 API 私钥和 HMAC-SHA512 算法创建一个 HMAC 对象。 -
base64.b64encode(mac.digest())：对 HMAC 结果进行 Base64 编码。 -
sigdigest.decode()：将 Base64 编码后的字节串解码为字符串，得到最终的 API 签名。
重要提示：
- 请务必妥善保管您的 API 私钥，不要泄露给他人。
- nonce 值必须是唯一的，并且建议使用时间戳来生成 nonce。
- 请仔细阅读交易所的 API 文档，了解具体的签名规则和参数要求。
- 不同的交易所可能使用不同的签名算法和参数，请根据实际情况进行调整。
示例
api_secret = "YOUR_API_SECRET"
#
替换为你的 Kraken 交易所 API 私钥。这是用于安全验证你的 API 请求的关键凭证。务必妥善保管此私钥，避免泄露，以防止未授权访问你的账户。
api_path = "/0/private/Balance"
定义 API 请求的路径。此处
/0/private/Balance
指的是 Kraken 交易所的私有 API 端点，用于查询账户余额。不同的 API 功能对应不同的路径，例如交易、订单管理等。
api_post = {"nonce": 1678886400000}
构造 POST 请求的数据负载。
nonce
是一个必须的参数，代表一个唯一的数字，用于防止重放攻击。每次 API 请求都应该使用一个不同的
nonce
值，通常是 Unix 时间戳的毫秒表示。请确保 Nonce 的值是递增的，避免重复使用。
nonce = 1678886400000
nonce
变量用于存储当前的 Nonce 值，并用于生成签名。 需要保证每次请求的 nonce 值不同。
signature = generate_kraken_signature(api_secret, api_path, api_post, nonce)
使用
generate_kraken_signature
函数生成 Kraken API 请求的数字签名。 此签名用于验证请求的来源和完整性，确保请求未被篡改。
该函数接受四个参数：
api_secret
(API 私钥),
api_path
(API 路径),
api_post
(POST 请求数据),
nonce
(随机数)。
签名生成过程通常涉及使用 API 私钥对包含 API 路径、POST 数据和 Nonce 的字符串进行哈希运算，常见的哈希算法包括 SHA256 或 HMAC-SHA256。
print(signature)
打印生成的数字签名。 在实际应用中，此签名将作为请求头的一部分发送到 Kraken 交易所的 API 服务器。
5. 常见交易类型与下单参数
Kraken API 支持多种交易类型，允许交易者根据市场情况和风险偏好执行不同的交易策略。以下详细介绍各种交易类型及其所需的下单参数：
-
市价单 (Market Order)：
以当前市场最优价格立即成交。市价单保证成交，但不保证成交价格，最终成交价格可能与下单时看到的价格略有偏差，特别是交易量较大或市场波动剧烈时。
-
type:market - 适用场景： 追求快速成交，对价格不敏感的交易者。
- 风险提示： 滑点风险，实际成交价格可能与预期不符。
-
-
限价单 (Limit Order)：
以指定的价格或更优的价格成交。买入时，只有当市场价格低于或等于指定价格时才会成交；卖出时，只有当市场价格高于或等于指定价格时才会成交。限价单不保证立即成交，但可以控制成交价格。
-
type:limit -
price: 指定的限价。必须是一个数字，表示希望成交的价格。 - 适用场景： 期望以特定价格买入或卖出，对成交时间不敏感的交易者。
- 风险提示： 可能无法成交，如果市场价格一直未达到指定价格。
-
-
止损单 (Stop Loss Order)：
当市场价格达到指定的止损价格时，系统自动提交一个市价单。止损单用于限制潜在亏损。
-
type:stop-loss -
price: 止损价格。当市场价格达到或超过这个价格时，市价单被触发。 - 适用场景： 保护利润或限制亏损。
- 风险提示： 止损价格可能被突破，导致实际成交价格低于止损价格（尤其是在市场快速下跌时）。
-
-
止损限价单 (Stop Loss Limit Order)：
当市场价格达到指定的止损价格时，系统自动提交一个限价单。与止损单相比，止损限价单允许交易者指定成交价格范围，但成交可能性更低。
-
type:stop-loss-limit -
price: 止损价格。当市场价格达到或超过这个价格时，限价单被触发。 -
price2: 限价。触发后提交的限价单的价格。 - 适用场景： 更精确地控制止损价格，避免在市场波动剧烈时以过低的价格成交。
- 风险提示： 如果市场价格快速下跌，可能无法成交，因为限价可能过低。
-
-
止盈单 (Take Profit Order)：
当市场价格达到指定的止盈价格时，系统自动提交一个市价单。止盈单用于锁定利润。
-
type:take-profit -
price: 止盈价格。当市场价格达到或低于（卖出止盈）或达到或高于（买入止盈）这个价格时，市价单被触发。 - 适用场景： 锁定利润，避免利润回吐。
- 风险提示： 止盈价格可能被突破，导致实际成交价格低于止盈价格（尤其是在市场快速上涨时）。
-
-
止盈限价单 (Take Profit Limit Order)：
当市场价格达到指定的止盈价格时，系统自动提交一个限价单。与止盈单相比，止盈限价单允许交易者指定成交价格范围，但成交可能性更低。
-
type:take-profit-limit -
price: 止盈价格。当市场价格达到或低于（卖出止盈）或达到或高于（买入止盈）这个价格时，限价单被触发。 -
price2: 限价。触发后提交的限价单的价格。 - 适用场景： 更精确地控制止盈价格，避免在市场波动剧烈时以过低的价格成交。
- 风险提示： 如果市场价格快速上涨，可能无法成交，因为限价可能过高。
-
下单时，除了指定交易类型，还需要提供以下关键参数：
-
pair: 交易对，指定交易的资产对。例如，"XBTUSD" 表示比特币/美元交易对，"ETHUSD"表示以太坊/美元交易对。务必使用Kraken API支持的有效交易对。 -
type: 订单类型，如 "market"（市价单）, "limit"（限价单）, "stop-loss"（止损单）, "stop-loss-limit"（止损限价单）, "take-profit"（止盈单）, "take-profit-limit"（止盈限价单）。 -
ordertype: 订单方向，指定是买入 ("buy") 还是卖出 ("sell")。 -
volume: 交易量，表示要买入或卖出的资产数量。必须是一个正数，并且符合交易平台对该交易对的最小交易量要求。 -
price: 价格，仅限限价单、止损限价单和止盈限价单需要指定。 对于限价单，这是期望成交的价格。对于止损限价单和止盈限价单，这是触发限价单的价格。 -
price2: 第二个价格参数，仅止损限价单和止盈限价单需要指定。 这是触发后限价单的实际价格。 -
leverage: 杠杆倍数 (可选)。用于放大交易头寸。例如，2x 杠杆意味着交易者只需要投入 50% 的资金即可控制 100% 的头寸。 请注意，使用杠杆会增加潜在收益，但也会增加潜在亏损。 并非所有交易对都支持杠杆交易，且不同交易对的杠杆倍数限制可能不同。 请谨慎使用杠杆。 -
starttm：指定订单开始时间 (可选)。可以指定订单在未来某个时间点开始生效。格式为 Unix 时间戳。 -
expiretm：指定订单过期时间 (可选)。可以指定订单在某个时间点过期，如果未成交则自动取消。格式为 Unix 时间戳。 -
close：用于创建条件收盘订单 (可选)。用于在开仓后设置止盈/止损。 -
ordertype：收盘订单类型（例如limit,stop-loss）。 -
price：收盘订单的价格。
以下是一个简化的Python示例，展示了如何使用API下一个限价买单。这只是一个概念性的例子，需要根据Kraken API的具体要求和你的账户信息进行修改：
import requests
import time
# 注意：这只是一个示例，需要根据Kraken API文档进行修改
# 并且需要处理API密钥和签名等安全问题
# 例如：
# url = "https://api.kraken.com/0/private/AddOrder"
# payload = {
# "pair": "XBTUSD",
# "type": "buy",
# "ordertype": "limit",
# "price": "20000",
# "volume": "0.01"
# }
# headers = {'API-Key': 'YOUR_API_KEY', 'API-Sign': 'YOUR_API_SIGNATURE'}
# response = requests.post(url, headers=headers, data=payload)
# print(response.())
generate_kraken_signature
函数定义详解
为了与 Kraken 交易所的 API 进行安全交互，生成有效的签名至关重要。以下代码片段展示了如何配置 API 密钥、构建请求参数以及生成必要的签名。
api_url = "https://api.kraken.com"
：定义 Kraken 交易所 API 的基础 URL。所有 API 请求都将以此 URL 为起点。
api_key = "YOUR_API_KEY"
：你的 Kraken API 密钥。务必将其替换为你实际的 API 密钥。API 密钥用于身份验证。
api_secret = "YOUR_API_SECRET"
：你的 Kraken API 私钥。同样，必须替换为你实际的私钥。私钥用于生成签名，保证请求的安全性。请妥善保管你的私钥。
api_path = "/0/private/AddOrder"
：指定要调用的 API 端点。在此示例中，我们使用
/0/private/AddOrder
端点来下单。
pair = "XBTUSD"
：交易对。这里设置为比特币兑美元 (XBTUSD)。选择合适的交易对取决于你的交易目标。
ordertype = "buy"
：订单类型。设置为 "buy" 表示买入订单。
type = "limit"
：限价单类型。表示以指定价格或更优价格执行订单。
price = "27000"
：设定的限价。订单只有在市场价格达到或低于 27000 美元时才会执行。
volume = "0.01"
：交易量。表示购买 0.01 个比特币。
nonce = int(time.time() * 1000)
：生成一个唯一 nonce 值。Nonce 是一个时间戳，用于防止重放攻击。每次 API 请求都应使用不同的 nonce 值。
api_post = { "pair": pair, "type": ordertype, "ordertype": type, "price": price, "volume": volume, "nonce": nonce }
：构建 API 请求的 POST 数据。包含了交易对、订单类型、价格、交易量和 nonce 等参数。
signature = generate_kraken_signature(api_secret, api_path, api_post, nonce)
：调用
generate_kraken_signature
函数，使用私钥、API 路径、POST 数据和 nonce 生成签名。这个签名是验证请求有效性的关键。
headers = { "API-Key": api_key, "API-Sign": signature }
：设置 HTTP 请求头。
API-Key
包含了你的 API 密钥，
API-Sign
包含了生成的签名。这些头部信息用于身份验证和请求验证。
url = api_url + api_path
：构建完整的 API 请求 URL。将基础 URL 与 API 路径连接起来。
response = requests.post(url, headers=headers, data=api_post)
：使用
requests
库发送 POST 请求。包含了 URL、请求头和 POST 数据。
requests
库需要提前安装 (
pip install requests
)。
print(response.text)
：打印 API 响应的内容。这将显示服务器返回的数据，例如订单的状态或错误信息。 使用
response.()
可以将返回的 字符串转换为 python 对象，方便操作。
6. 错误处理与速率限制
在使用 Kraken API 进行数据交互时，务必高度重视错误处理机制以及速率限制策略，这对于保证应用程序的稳定性和避免不必要的服务中断至关重要。
-
错误处理：
Kraken API 的响应数据通常采用 JSON 格式。当请求执行完毕后，服务器会返回一个包含状态信息的 JSON 对象。该对象中的
error字段扮演着关键的角色，它用于明确指示本次 API 请求是否成功完成。若error字段的内容为空，则意味着请求顺利执行；反之，如果error字段包含任何数据，则表明请求过程中出现了某种错误。开发者应仔细解析error字段中的错误代码，并根据不同的错误代码采取相应的应对措施，例如重新构造请求、调整参数或进行错误日志记录。 -
速率限制：
为了防止 API 被恶意滥用或过度使用，Kraken API 实施了严格的速率限制策略。这些限制措施具体取决于所使用的 API 密钥的权限级别以及请求的频率。换句话说，不同的 API 密钥可能具有不同的请求配额和时间窗口。一旦请求频率超过了预设的速率限制，API 服务器将会返回 HTTP 错误代码 429 (Too Many Requests)，表示客户端请求过于频繁。为了避免触发速率限制并导致账号被暂时或永久封禁，开发者需要谨慎调整其应用程序的请求频率。一种常用的方法是利用
time.sleep()函数在连续的 API 请求之间引入适当的延迟，从而有效地控制请求速率。建议开发者仔细查阅 Kraken API 的官方文档，了解关于速率限制的具体细节和最佳实践。
7. 高级用法
除了标准的现货交易功能，Kraken API还提供了多种高级功能，旨在满足经验丰富的交易者和机构投资者的复杂需求。这些高级用法扩展了基础交易功能，并允许用户实现更精细的交易策略。
- 条件订单： Kraken API允许创建各种条件订单，例如止损订单（Stop Loss Orders）、止盈订单（Take Profit Orders）、止损限价订单（Stop Loss Limit Orders）和跟踪止损订单（Trailing Stop Loss Orders）。这些订单类型允许交易者在价格达到特定水平时自动执行交易，从而更好地管理风险并锁定利润。通过预先设定的条件，用户可以免于持续监控市场，并对价格波动做出快速反应。
- 杠杆交易： 通过Kraken API，用户可以使用杠杆进行交易。杠杆交易允许交易者以相对较少的自有资金控制更大的仓位，从而放大潜在的收益。然而，杠杆也会放大潜在的损失，因此在使用杠杆之前，必须充分了解相关风险。Kraken提供不同级别的杠杆，具体取决于交易的资产和用户的账户设置。
- WebSocket API： Kraken的WebSocket API提供了一种实时获取市场数据的高效方法。与传统的REST API相比，WebSocket API使用持久连接，允许服务器在数据更新时立即将信息推送给客户端，从而显著降低延迟。这对于需要高速数据流的交易策略，例如高频交易和算法交易至关重要。用户可以通过WebSocket API订阅各种市场数据流，例如实时价格更新、订单簿信息和交易历史记录。
要充分利用这些高级功能并优化您的交易策略，请务必查阅Kraken API的官方文档，其中包含详细的参数说明、使用示例和最佳实践指南。 理解API的限制和细微之处对于成功实施这些高级功能至关重要。
