如何从Kraken API获取历史合同数据？

了解Kraken API和历史合同数据

Kraken API是一个强大的接口，使开发人员和交易者能够以编程方式与Kraken的加密货币交换服务进行交互。在参考历史合同数据时，重要的是要澄清Kraken主要通过其Kraken Futures Platform（以前称为Cryptowatch衍生品）来支持现货交易和期货合约。标准Kraken REST API（API.KRAKEN.COM）不直接提供期货或永久合同的历史数据。取而代之的是，可以通过Futures-api.kraken.com托管的Kraken Futures API访问历史合同数据。

要检索历史数据，您必须根据所需的合同和时间范围的类型确定正确的端点。 Kraken Futures API提供诸如/api/history/candles等终点，以获取特定期货合约的OHLC（开放，高，低，关闭）数据。每个端点都需要参数，例如符号，间隔和从/直到时间戳来定义数据范围。

设置API访问凭据

在提出任何请求之前，您必须设置对Kraken Futures API的经过身份验证的访问。这涉及创建一个API密钥和秘密：

• 登录到您的Kraken帐户并导航到资金部分。
• 选择API并选择Kraken Futures 。
• 单击创建API键。
• 分配许可证 - 启用读取访问的市场数据。
• 生成密钥，并安全地存储API密钥和秘密密钥。

这些凭据必须使用HMAC-SHA256签署请求。与现货交易不同，Kraken Futures使用单独的身份验证机制。每个请求都必须包括诸如APIKey和Authent标题，在该Authent中，根据请求方法，路径，车身和时间戳是计算的签名。

构建API的历史数据请求

要检索历史合同数据，请使用蜡烛历史终点：

 GET https://futures-api.kraken.com/api/history/candles

所需的查询参数包括：

• 符号：合同符号，例如Bitcoin永久逆同合同的PI_XBTUSD 。
• 间隔：烛台间隔。有效值包括1m ， 5m ， 15m ， 1h ， 4h ， 1d 。
• 来自：在UNIX时间戳（秒）中开始时间。
• 直到：unix时间戳中的结束时间（秒）。

例如，从2024年1月1日至2024年1月2日，以获取Bitcoin永久合同的1小时蜡烛：

 https://futures-api.kraken.com/api/history/candles?symbol=PI_XBTUSD&interval=1h&from=1704067200&until=1704153600

如果仅访问公共市场数据，则此请求不需要身份验证。但是，如果限制限制，请考虑使用身份验证的请求。

处理限制要求的身份验证

如果您超过了未经身份验证的请求限制，请切换到签名的请求。该过程涉及：

• 使用方法，路径，车身和ISO 8601时间戳创建请求有效负载。
• 将时间戳，方法，路径和身体（如果存在）连接到签名字符串中。
• 将HMAC-SHA256与您的秘密键一起生成签名。
• 包括Authent标头中的签名和APIKey中的钥匙。

python中的示例步骤：

• 设置请求方法： GET
• 定义路径： /api/history/candles?symbol=PI_XBTUSD&interval=1h&from=1704067200&until=1704153600
• 生成ISO时间戳： 2024-01-01T00:00:00Z
• 构建签名消息： 2024-01-01T00:00:00ZGET/api/history/candles?symbol=PI_XBTUSD&interval=1h&from=1704067200&until=1704153600
• 使用您的秘密密钥计算消息的HMAC-SHA256
• 编码base64中的结果
• 设置标题：
  • APIKey: YOUR_PUBLIC_KEY
  • Authent: BASE64_SIGNATURE
  • Nonce: 2024-01-01T00:00:00Z

使用库之类的requests发送请求。

处理和存储响应数据

API返回包含蜡烛对象数组的JSON响应。每个蜡烛都包括：

• 时间戳：蜡烛的时间开始。
• 开放：开头。
• 高：最高价格。
• 低：最低的价格。
• 关闭：收盘价。
• 数量：交易数量。

示例响应：

 { 'result': 'success', 'candles': [ { 'timestamp': 1704067200, 'open': '42000.00', 'high': '42500.00', 'low': '41800.00', 'close': '42300.00', 'volume': '120.5' }

这是给出的}

解析JSON并提取candles阵列。您可以将此数据存储在CSV，数据库或数据框架中以进行分析。确保根据需要将时间戳转换为本地时间或UTC。如果时间范围很大，则处理分页 - Kraken可能会限制每个请求的结果，需要多次from和until值调整为止。

常见错误和故障排除

• 无效符号：双检查合同符号。使用GET /api/instruments列出所有可用合同。
• 利率限制：未经身份验证的请求受到限制。使用身份验证或在呼叫之间添加延迟。
• 无效时间戳格式：确保UNIX时间戳为几秒钟，而不是毫秒。
• 签名不匹配：验证签名字符串包含确切的路径和查询参数，并且秘密键是正确的。
• 空响应：确认时间范围包括主动交易期。

使用Postman或Python脚本等工具来逐步测试请求。启用记录以捕获请求标题和调试的响应。

常见问题

如何找到Kraken Futures合同的正确符号？使用仪器端点： GET https://futures-api.kraken.com/api/instruments 。这将返回所有具有其符号的活动合同，例如Bitcoin perpetuals的PI_XBTUSD或以太期货的FI_ETHUSD 。

我可以检索刻度级的历史数据而不是蜡烛吗？ Kraken Futures API不会通过公共端点提供tick级数据。 /api/history/candles端点仅在指定的间隔内支持汇总的OHLC数据。对于颗粒数据，请考虑Websocket Feeds或第三方数据提供商。

我一次可以获取多少历史数据有限制吗？是的，API可能会限制每个请求返回的蜡烛数量。如果您的时间范围很大，则将其分为较小的间隔（例如一次），然后提出多个请求。检查响应的完整性，并from和until参数相应地调整。

我需要成为经过验证的Kraken用户才能访问历史合同数据吗？对于未经验证的公共数据请求，基本帐户访问就足够了。但是，为了提高利率限制并确保稳定访问，建议使用API凭据的验证帐户。数据检索不需要完整的交易许可。