Kraken API接口调用指南：快速上手与密钥管理

调用示例 (Python):

本示例展示了如何使用Python与加密货币交易所或API进行交互，进行身份验证并调用相关接口。示例中使用了`requests`库发送HTTP请求，`hashlib`库进行哈希运算，`hmac`库用于创建哈希消息认证码，`time`库获取时间戳，`base64`库进行Base64编码。

import requests ：导入 requests 库，这是一个常用的Python HTTP客户端库，用于发送HTTP请求，例如GET、POST等。使用前需要确保已经安装该库，可以通过 pip install requests 命令进行安装。

import hashlib ：导入 hashlib 库，该库提供多种哈希算法，例如MD5、SHA-1、SHA-256等。在加密货币API调用中，哈希算法常用于生成请求签名，确保数据的完整性和安全性。

import hmac ：导入 hmac 库，HMAC（Hash-based Message Authentication Code）是一种使用哈希函数构造消息认证码的算法，常用于验证消息的完整性和来源。HMAC需要一个密钥和一个消息作为输入，输出一个固定长度的哈希值，该哈希值可以用于验证消息的完整性，确保消息在传输过程中没有被篡改。

import time ：导入 time 库，该库提供与时间相关的功能，例如获取当前时间戳。时间戳常用于API请求中，防止重放攻击，即攻击者截获并重放之前的请求。

import base64 ：导入 base64 库，该库提供Base64编码和解码功能。Base64是一种将二进制数据转换为ASCII字符串的编码方式，常用于在HTTP请求中传输二进制数据，例如API密钥。

API 密钥和私钥

在与加密货币交易所或相关服务进行交互时，API 密钥和私钥是至关重要的安全凭证。它们如同访问特定账户和功能的通行证，必须妥善保管，避免泄露。

API_KEY = "YOUR_API_KEY"

API_KEY （API 密钥）是一个公开的标识符，用于识别您的应用程序或账户。它可以被公开使用，例如在 API 请求中声明您的身份，告知服务器请求的来源。但它本身不具备授权操作的能力，类似于用户名。

API_SECRET = "YOUR_API_SECRET"

API_SECRET （API 私钥）则是一个高度敏感的秘密，必须严格保密。它与 API_KEY 配对使用，用于验证 API 请求的真实性和授权用户的操作。泄露 API_SECRET 相当于泄露了账户的控制权，可能导致资金损失或其他严重安全问题。切勿将私钥存储在公开的代码仓库、客户端应用程序或任何不安全的地方。

请务必将 YOUR_API_KEY 和 YOUR_API_SECRET 替换为您从交易所或服务提供商处获得的真实密钥。获取方式通常在其 API 文档或账户设置中有所说明。密钥生成后，请立即将其存储在安全的地方，并定期轮换，以降低安全风险。

Kraken API 基本 URL

Kraken API 的基本 URL 是所有 API 请求的入口点，指向 Kraken 服务器。 确保使用正确的 URL 以避免连接错误。 目前，Kraken API 的主 URL 为：

API_URL = "https://api.kraken.com"

此 URL 应该作为构建任何 API 请求的基础。 请务必始终使用 HTTPS 以确保数据传输的安全性。

get_kraken_signature 函数用于生成 Kraken API 请求所需的签名。 此签名用于验证请求的真实性，防止恶意篡改。

def get_kraken_signature(urlpath, data, secret): post_data = urllib.parse.urlencode(data) encoded = (urlpath + hashlib.sha256((str(data['nonce']) + post_data).encode()).hexdigest()).encode() hmac_digest = hmac.new(base64.b64decode(secret), encoded, hashlib.sha512) signature = base64.b64encode(hmac_digest.digest()) return signature.decode()

该函数接收三个参数：

• urlpath : API 端点的路径，例如 "/0/private/Balance"。
• data : 包含请求参数的字典，包括 nonce 。
• secret : 您的私有 API 密钥，用于生成签名。

签名生成过程包括以下步骤：

1. 使用 urllib.parse.urlencode 将请求数据字典编码为 URL 编码的字符串。
2. 将 URL 路径与使用 SHA256 哈希算法处理的 nonce 和编码后的数据连接起来。
3. 使用 HMAC-SHA512 算法，使用 Base64 解码后的私有密钥对连接后的字符串进行哈希处理。
4. 将生成的 HMAC 摘要进行 Base64 编码，得到最终的签名。
5. 将签名解码为 UTF-8 字符串并返回。

kraken_request 函数封装了向 Kraken API 发送请求的逻辑。它负责设置必要的头部信息，包括 API 密钥和签名。

def kraken_request(uri_path, data=None, api_key=None, api_sec=None): headers = {} if api_key and api_sec: data['nonce'] = str(int(1000*time.time())) headers['API-Key'] = api_key headers['API-Sign'] = get_kraken_signature(uri_path, data, api_sec)

该函数接收以下参数：

• uri_path : API 端点的路径。
• data : 请求数据字典 (可选)。
• api_key : 您的公共 API 密钥 (可选，用于需要身份验证的请求)。
• api_sec : 您的私有 API 密钥 (可选，用于需要身份验证的请求)。

如果提供了 api_key 和 api_sec ，该函数将：

1. 生成一个唯一的 nonce 值（基于当前时间戳），并将其添加到请求数据中。Nonce 用于防止重放攻击。
2. 将 API 密钥添加到 API-Key 头部。
3. 使用 get_kraken_signature 函数生成签名，并将其添加到 API-Sign 头部。

req = requests.post((API_URL + uri_path), headers=headers, data=data)
return req

该函数使用 requests.post 方法向 Kraken API 发送 POST 请求。请求 URL 由基本 URL 和 uri_path 组成，头部信息包含 API 密钥和签名，请求数据包含在 data 参数中。 函数返回 requests.post 方法的响应对象。

获取账户余额

本节介绍如何通过Kraken API获取账户余额。以下Python代码展示了如何使用 kraken_request 函数向Kraken服务器发送请求，并处理返回的数据。

def get_account_balance():

定义一个名为 get_account_balance 的函数，用于获取账户余额信息。

uri_path = "/0/private/Balance"

设置API端点路径。 /0/private/Balance 是Kraken API中用于查询账户余额的私有端点，需要有效的API密钥和私钥进行身份验证。

data = {}

创建一个空字典 data ，用于存储需要传递给API的任何参数。在此案例中，获取账户余额不需要额外的参数，因此 data 字典为空。

response = kraken_request(uri_path, data, API_KEY, API_SECRET)

调用 kraken_request 函数发送API请求。该函数接收API端点路径 uri_path 、请求数据 data 、API密钥 API_KEY 和API私钥 API_SECRET 作为参数，并返回包含API响应的对象。 API_KEY 和 API_SECRET 是预先设置的环境变量，用于身份验证。

if response.status_code == 200:
    return response.()
else:
    print(f"Error: {response.status_code} - {response.text}")
    return None

检查API响应的状态码。如果状态码为 200 ，表示请求成功，API返回了有效数据。使用 response.() 方法将JSON格式的响应数据解析为Python字典并返回。

如果状态码不是 200 ，则表示请求失败。打印包含错误状态码和错误信息的调试消息，并返回 None ，表明获取账户余额失败。这有助于调试API调用中可能出现的问题。

添加订单 (限价单示例)

add_order 函数用于在 Kraken 交易所提交一个新的订单。以下示例展示了如何创建一个限价单。该函数接收以下参数：

• pair : 交易对，例如 "XBTUSD" (比特币/美元)。务必使用 Kraken 支持的交易对。
• type : 订单类型，指定为 "buy" (买入) 或 "sell" (卖出)。
• order_type : 订单类型，对于限价单，应设置为 "limit"。
• volume : 订单数量，表示要交易的资产数量。
• price : 限价单的价格，即希望买入或卖出的价格。

函数体内部，首先定义了 Kraken API 的 URI 路径 /0/private/AddOrder ，该路径用于提交新的订单请求。 然后，创建一个包含订单参数的字典 data 。 该字典包含了上述所有必要的参数：交易对 ( pair )，订单类型 ( type )，订单子类型 ( ordertype )，交易数量 ( volume ) 以及指定的价格 ( price )。

def add_order(pair, type, order_type, volume, price): uri_path = "/0/private/AddOrder" data = { "pair": pair, "type": type, # "buy" or "sell" "ordertype": order_type, # "limit" "volume": volume, "price": price } response = kraken_request(uri_path, data, API_KEY, API_SECRET)

接着，使用 kraken_request 函数向 Kraken API 发送请求。 kraken_request 函数接受 URI 路径 uri_path ，订单数据 data ，以及 API 密钥 API_KEY 和 API 私钥 API_SECRET 作为参数。 API 密钥和私钥用于对请求进行身份验证，确保只有授权用户才能提交订单。 kraken_request 函数负责处理与 Kraken API 的通信，包括构建请求，发送请求和接收响应。

if response.status_code == 200:
    return response.()
else:
    print(f"Error:  {response.status_code} - {response.text}")
    return None

该函数检查 Kraken API 的响应状态码。 如果状态码为 200，表示请求已成功处理，函数将解析 JSON 格式的响应数据并返回。 如果状态码不是 200，表示发生了错误，函数将打印错误消息，包括状态码和响应文本，并返回 None 。

注意: API_KEY 和 API_SECRET 是占位符，需要替换为你自己的 Kraken API 密钥和私钥。请妥善保管你的 API 密钥和私钥，不要泄露给他人。

调用示例

在Python脚本中，通过检查 if __name__ == "__main__": 来确保只有当脚本直接运行时，以下代码块才会被执行。这种做法避免了脚本作为模块被导入时执行不必要的代码。示例中， get_account_balance() 函数被调用，用于获取账户余额。随后，检查返回值 balance 是否为真（即余额存在）。如果账户余额存在，则会打印出账户余额信息。这是一种常见的在程序启动时检查账户状态的方法。

# 添加一个买入 BTC/USD 的限价单
# 使用 add_order 函数提交一个买入比特币（BTC/USD 交易对）的限价单。
# "XBTUSD" 代表比特币/美元的交易对，是BitMEX等交易所常用的符号。
# "buy"  指定订单类型为买入。
# "limit"  指定订单类型为限价单，意味着只有当市场价格达到或低于指定价格时，订单才会执行。
# "0.001"  代表订单数量，这里是 0.001 个比特币。需要注意的是，不同交易所对于数量的精度要求可能不同，此处应符合交易所的最小交易单位要求。
# "26000"  是设定的限价，即 26000 美元。只有当市场价格达到或低于 26000 美元时，该买单才会被执行。

order_response = add_order("XBTUSD", "buy", "limit", "0.001", "26000")
if order_response:
    print("Order Response:", order_response)
# 订单提交后，`order_response` 变量会接收到来自交易所的响应信息。
# 通过检查 `order_response` 是否为真，我们可以确定订单是否成功提交。
# 如果订单成功提交，响应信息会被打印出来，通常包含订单ID、状态和其他相关信息，方便用户进行追踪。

代码解释：

• 这段代码展示了如何使用 Python 编程语言与 Kraken 加密货币交易所的 API 进行交互，核心在于利用 requests 库发送和接收 HTTP 请求。
• get_kraken_signature 函数至关重要，它负责生成符合 Kraken API 规范的身份验证签名。为了保障交易安全，Kraken 采用 HMAC-SHA512 算法对请求数据进行加密签名，此签名随后会作为请求头的一部分发送到服务器，用以验证请求的合法性。该函数接收私钥和请求数据作为输入，经过哈希运算后生成最终的签名。
• kraken_request 函数是一个请求构造器，它封装了向 Kraken API 发送请求的完整流程。该函数接收 API 终点 URL、请求参数等信息，并自动添加必要的 API 密钥和由 get_kraken_signature 函数生成的签名头。通过统一处理身份验证和请求发送，简化了与 Kraken API 的交互过程，并提高了代码的可维护性。同时，该函数也负责处理 HTTP 响应，并返回 API 的返回结果。
• get_account_balance 函数专门用于调用 Kraken API 的余额查询接口。它利用 kraken_request 函数发送请求，获取当前账户的资金余额信息，例如各种加密货币的持有数量。
• add_order 函数的功能是在 Kraken 交易所中创建新的交易订单。它同样借助 kraken_request 函数发送 API 请求，并传递订单类型（买/卖）、交易货币对、数量、价格等参数。成功执行后，将在 Kraken 平台上下达指定参数的交易指令。
• if __name__ == "__main__": 块是 Python 脚本的入口点。只有当脚本直接运行时，该代码块中的代码才会被执行。在此示例中，该代码块演示了如何调用 get_account_balance 和 add_order 等函数，展示了完整的 API 调用流程。需要注意的是，实际应用中需要替换示例代码中的 API 密钥和订单参数为真实有效的值。

1. 将请求参数进行 URL 编码。
2. 将 URL 路径和编码后的请求参数连接起来。
3. 使用私钥对连接后的字符串进行 HMAC-SHA512 签名。
4. 将签名添加到请求头中。

具体的签名算法可能会因 API 提供商而异，请务必参考 Kraken 的官方文档。