如何使用Kraken的REST API？

Kraken的REST API使您可以自动交易并管理您的帐户；它需要设置具有签名的API键和身份验证请求。

2025/04/24 04:56

使用Kraken的REST API，您可以与Kraken加密货币交易所进行编程交互，从而使您能够自动交易，管理帐户和检索市场数据。本文将指导您完成设置和使用Kraken的REST API的过程，涵盖身份验证，提出请求并了解API的结构。

了解Kraken的休息API

Kraken的REST API是一种强大的工具，设计了需要以编程方式与交易所进行交互的开发人员。 API分为两个主要类别：公共和私人端点。公共终点允许访问市场数据，例如股票信息，订单书和最近的交易。另一方面，私人端点需要身份验证并提供对用户特定数据的访问，包括帐户余额，订单管理和贸易历史记录。

设置API键

在使用私有端点之前，您需要设置API键。这是这样做的方法：

• 登录到您的Kraken帐户并导航到设置部分。
• 单击API以访问API管理页面。
• 单击生成新键。将提示您输入键的名称，并选择要授予的权限。
• 生成密钥后，您将看到一个API键和API秘密。安全保存，因为它们将用于验证您的API请求。

身份验证的API请求

为了验证您对私人端点的请求，您需要在请求中包含一个签名。这是创建签名的方法：

• 生成一个nonce ，这是一个只能使用一次的唯一数字。您可以为此目的使用当前的时间戳。
• 创建您要求的API路径（例如， /0/private/Balance ）。
• 将nonce和帖子数据（如果有）串联到一个字符串中。
• 通过连接API路径，API NONCE和POST数据字符串来创建消息。
• 使用SHA-256算法来哈希。
• 将HMAC-SHA512算法与您的API秘密一起签名。
• 在请求标题中包括API密钥，NONCE和签名。

这是一个示例Python代码段来说明该过程：

 import time
 import hashlib
 import hmac
 import requests api_key ='your_api_key'
 api_secret ='your_api_secret'.encode（）







def get_kraken_signature（urlpath，数据，秘密）：






postdata = urllib.parse.urlencode(data) encoded = (str(data['nonce']) + postdata).encode() message = urlpath.encode() + hashlib.sha256(encoded).digest() signature = hmac.new(secret, message, hashlib.sha512) return signature.hexdigest()
 def kraken_request（uri_path，data，api_key，api_secret）：
 
headers = {} headers['API-Key'] = api_key headers['API-Sign'] = get_kraken_signature(uri_path, data, api_secret) req = requests.post((api_url + uri_path), headers=headers, data=data) return req
示例用法
api_url ='https://api.kraken.com'
 uri_path ='/0/私人/余额'
 data = {'nonce'：str（int（1000*time.time（））}}
 RESS = kraken_request（uri_path，数据，api_key，api_secret）

提出API请求

设置API键并了解如何验证请求后，您可以开始拨打API调用。以下是一些共同请求的示例：

• 公共端点示例：检索股票信息

  • URL： https://api.kraken.com/0/public/Ticker?pair=XBTUSD pair=xbtusd
  • 此请求将将Bitcoin的当前股票信息返回到美元对。

• 私人端点示例：检查帐户余额

  • URL： https://api.kraken.com/0/private/Balance
  • 您需要如前所述包括身份验证标头。

处理响应

Kraken的API以JSON格式返回响应。这是处理响应的方法：

• 使用您选择的编程语言中使用JSON解析器来解析JSON响应。
• 检查响应中的错误字段。如果不是零，则意味着发生错误，您应该相应地处理。
• 提取结果字段以访问API返回的数据。

这是如何处理Python响应的一个示例：

 import json假设“ resp”是kraken_request函数的响应对象
response_json = resp.json（）






如果响应中的'错误'和response_json ['error']：






print('Error:', response_json['error'])
别的：
 
print('Result:', response_json['result'])
利率限制和最佳实践
Kraken的API具有防止滥用的费率限制。您应该意识到这些限制并在您的代码中采取适当的措施：
 
公共端点的限制为每秒15个请求。
私人端点的未经验证帐户的限制为每秒1个请求，经过验证的帐户每秒最多20个请求。
以下是一些最佳实践：
 
实现带指数退回的重试逻辑，以处理速率限制错误。
缓存经常访问数据以减少请求的数量。
使用异步请求提高应用程序的效率。
解决常见问题
使用Kraken的REST API时，您可能会遇到一些常见问题。以下是一些故障排除提示：
 
无效的签名：双检查您的nonce是唯一的，并且您正确地签署了请求。
超过的利率限制：确保您尊重利率限制并实施适当的重试逻辑。
 API密钥问题：确保您的API密钥具有必要的权限，并且您使用的是正确的密钥和秘密。
常问问题
问：我可以使用Kraken的REST API同时交易多个加密货币吗？
 
答：是的，您可以使用Kraken的REST API来管理和交易多个加密货币。您需要为要交易的每个加密货币对进行单独的API调用，以确保您尊重速率限制并有效地管理API请求。
 
问：使用Kraken的REST API时，如何确保API键的安全性？
 
答：要确保API密钥的安全性，请将它们存储在安全的环境中，例如环境变量或安全库。切勿在源代码中对键进行硬式编码，然后将API键的权限限制为应用程序所需的最低限度。
 
问：Kraken的公共和私人终点之间有什么区别？
 
答：公共端点提供了对市场数据的访问，不需要身份验证。它们包括诸如股票数据，订单书和最近交易之类的信息。私人端点需要身份验证并提供对特定用户特定数据的访问，例如帐户余额，订单管理和贸易历史记录。
 
问：使用Kraken的REST API时，如何处理错误和异常？
 
答：要处理错误和异常，您应始终检查API响应中的“错误”字段。实施错误处理逻辑以管理不同类型的错误，例如超过速率限制，无效签名或服务器错误。使用代码中的try-catch块优雅地处理异常，并在适当的情况下实现重试逻辑。