如何使用Kraken API

了解Kraken API及其目的

Kraken API是一个强大的工具，可让开发人员和交易者以编程方式与Kraken CryptoCurrency Exchange进行交互。它可以自动交易，投资组合管理，实时市场数据检索和帐户监视，而无需依赖Web界面。 API支持两个公共终点，它们提供了市场数据，例如股票信息，订单簿和贸易历史记录以及需要身份验证的私人端点，并允许用户管理订单，检查余额和撤回资金。

要有效地使用Kraken API，您必须了解其两个主要组件： REST API和WebSockets API 。 REST API非常适合一次性请求，例如获取资产价格或下订单。 Websockets API用于实时数据流，例如实时价格更新或订单簿更改。这两个API分别均可通过HTTPS和WebSocket连接访问，并且通常需要以JSON格式使用请求和响应的正确格式。

设置您的Kraken API凭据

在进行任何API调用之前，您需要从Kraken帐户中生成API密钥和秘密。登录到您的Kraken帐户并导航到设置部分。单击“ API”选项卡，然后选择新的API键。将提示您为密钥设置权限。有关基本数据检索，请启用查询公共和查询私人选项。如果您打算进行交易或撤回资金，还可以启用贸易和撤回权限。谨慎对待权限，因为受损的钥匙可能会导致基金损失。

生成钥匙后，您将看到两个字符串：

• API键：用于标识您帐户的长字母数字字符串。
• API秘密：用于签名请求的基本64编码字符串。

安全地存储这些。不应在客户端代码或公共存储库中暴露API秘密。要在API请求中使用这些凭据，您必须使用HMAC-SHA512加密签署每个私人请求，而API Secret作为密钥和包含URI路径，NONCE和POST数据的消息。

执行公共API请求

公共端点不需要身份验证，可以通过HTTP获取请求直接访问。这些对于检索市场数据很有用。例如，要使用美元（BTC/USD）获取Bitcoin的当前股票信息，请使用以下端点：

 https://api.kraken.com/0/public/Ticker?pair=XXBTZUSD

响应将包括最后交易价格， 24小时的数量，高/低价和出价/询问率。其他公共终点包括：

• 资产：列出所有可交易对及其规格。
• 深度：返回给定对的当前订单书。
• 贸易：检索最近的贸易历史。
• OHLC ：提供用于图表的烛台数据。

每个公共请求都返回一个带有result字段的JSON对象，其中包含数据和error字段列出任何问题。通过在处理结果之前检查error阵列，确保您的应用程序可以优雅地处理错误。

签署和发送私人API请求

私有API调用需要使用API键和加密签名进行身份验证。每个请求都必须包括以下标题：

• API-Key ：您生成的API密钥。
• API-Sign ：消息的HMAC-SHA512签名。

要签署的消息包括：

• URI路径（例如， /0/private/Balance ）。
• 一个非CE值 - 严格增加的整数一次。
• 帖子数据（例如， nonce=1234567890 ）。

构建签名：

• 将消息串联为： path + SHA256(nonce + POST data) 。
• 使用解码的API秘密作为HMAC键。
• 将HMAC-SHA512应用于串联消息。

在Python中，可以将其实施为：

 import hashlib import hmac import time def get_kraken_signature（urlpath，数据，秘密）：






postdata = urllib.parse.urlencode(data) encoded = (str(data['nonce']) + postdata).encode() message = urlpath.encode() + hashlib.sha256(encoded).digest() mac = hmac.new(base64.b64decode(secret), message, hashlib.sha512) return base64.b64encode(mac.digest()).decode()
在向API-Sign提出帖子请求时，请在/0/private/Balance或/0/private/AddOrder中使用此签名。
 
实际用例和代码示例
常见用例是检查您的帐户余额。为此：
 

• 将发布请求发送到https://api.kraken.com/0/private/Balance 。
• 将nonce包括在邮局中。
• 设置API-Key和API-Sign标题。

另一个例子是下达限额购买订单：

• 使用/0/private/AddOrder端点。
• 包括参数，例如pair=XXBTZUSD ， type=buy ， ordertype=limit ， price=30000和volume=0.01 。
• 确保NUNCE大于前一个。

对于实时数据，请使用Websockets API。连接到wss://ws.kraken.com/v2 。订阅诸如ticker ， book或trade之类的渠道。例如，要实时BTC/USD交易：

{

“方法”：“订阅”， 'params'：{

'channel': 'trade', 'symbol': 'BTC/USD', 'snapshot': true

} }

服务器将在发生交易更新。使用应用程序中的事件侦听器处理传入消息。

安全最佳实践和限制费率

Kraken强加了限制限制以防止滥用。公共端点每秒最多允许10个请求。私人端点每秒限制为每秒15个请求。超过这些限制会导致暂时禁令。为了避免这种情况，请在代码中实现请求限制和指数向退缩。

通过：

• 将IP白色列入用于API键。
• 禁用不必要的许可。
• 定期旋转API键。
• 切勿以明文来记录或存储API秘密。

始终将HTTP用于Websocket的REST调用和WSS 。在生产环境中验证SSL证书。

常见问题

Kraken API请求中NONCE的正确格式是什么？ nonce必须是一个随着每个请求而增加的整数。大多数开发人员在微秒中使用UNIX时间戳。例如，python中的int(time.time() * 1000000)确保独特性和单调增长。重复使用或减少NONCE会导致API拒绝请求。

如何在不冒险的实际资金冒险的情况下测试Kraken API？ Kraken不提供沙盒环境。但是，您可以创建一个新的API密钥，而无需取消或交易权限，并使用它来测试余额查询和市场数据检索。用于交易模拟，获取市场数据并在本地模拟订单执行，而无需发送真实订单。

为什么我会得到“ EAPI：无效的密钥”错误？此错误表明API-KEY标头丢失，畸形或未识别。仔细检查键是否已从Kraken仪表板中精确复制并包含在请求标题中。另外，确保不存在额外的空间或线路断路。

我可以使用Kraken API检索历史烛台数据吗？是的。使用/0/public/OHLC端点，带有pair和interval参数。例如， pair=XXBTZUSD&interval=60返回1小时的蜡烛。响应包括时间，开放，高，低，关闭和音量数据。请注意，Kraken将历史数据限制为每个请求的一定数量的近期间隔。