如何使用 Kraken API 进行自动交易：开发人员指南

API认证和密钥管理

1. 通过 Kraken 的安全设置生成具有严格权限范围的 API 密钥 — 除非绝对必要，否则禁用“提取资金”。

2. 将密钥存储在环境变量或加密保管库中；切勿将它们硬编码到源文件中或提交到 Git 存储库。

3. 每 90 天轮换一次密钥，并立即使用 Kraken 控制面板撤销受损的密钥。

4. 对所有 API 端点实施 IP 白名单，以仅限制对已知基础设施地址的访问。

5. 通过使用 SHA-256 对有效负载进行哈希处理并使用以 base64 编码的密钥进行签名，对专用端点使用签名请求。

数据检索和速率限制策略

1. /public/Ticker和/public/AssetPairs等公共端点允许每秒最多 15 次调用，无需身份验证。

2. 专用端点强制执行滑动窗口限制：每 2 秒 20 个请求，通过X-RateLimit-Remaining标头进行跟踪。

3. 在接收 HTTP 429 响应时实现带有抖动的指数退避，以避免级联故障。

4. 在本地缓存资产对元数据至少 24 小时，因为它很少发生变化，从而减少约 68% 的冗余调用。

5.使用since参数批量OHLCV请求来有效地获取历史蜡烛，而不是重复轮询。

订单生命周期实施

1. 通过/private/AddOrder提交订单，其中必填字段为： ordertype 、 type 、 volume 、 pair和限价订单的price 。

2. 使用userref附加自定义标识符，以便在订单状态检查和交易历史记录查找之间进行协调。

3. 使用userref轮询/private/QueryOrders ，以在活动策略窗口期间以 100 毫秒的间隔确认执行。

4. 在提交替换之前使用/private/CancelOrder取消挂单，以防止重复成交。

5. 仔细解析descr和descr.order响应字段 - 它们包含必须解析价格、交易量和杠杆标志的原始指令字符串。

错误处理和弹性模式

1. 将EAPI：超出速率限制视为需要重试协调的非致命瞬态错误，而不是导致进程崩溃的异常。

2. 在请求序列化之前，将 Kraken 特定的错误代码（例如EGeneral:Invalid 参数）映射到结构化验证失败。

3. 仅当错误数组非空并编辑日志中的key 、 Secret和sig字段时，才记录完整的请求/响应正文。

4. 通过将描述价格与当前市场价差进行比较来检测陈旧订单状态——如果偏差超过 0.5%，则触发手动验证。

5. 维护持久的本地订单簿快照，每 5 秒通过/public/Depth更新一次，以在波动高峰期间交叉检查填充准确性。

常见问题解答

Q1：Kraken 是否支持 WebSocket 流式传输以进行实时订单簿更新？是的——Kraken 为 WebSocket v2 提供了book 、 trade和ohlc通道。订阅不需要对公共数据进行身份验证，但要求对像ownTrades这样的私人提要进行 API 密钥绑定。

问题 2：Kraken 如何处理 ADA/USD 等低流动性货币对的部分订单量？ Kraken 对每个资产对强制执行最低交易量阈值。对于 ADA/美元，最低为 10 ADA。低于此值的卷将被拒绝，并显示EInput：签名验证之前卷无效。

Q3：我可以直接通过REST API下止损单吗？是——在/private/AddOrder中使用ordertype=stop-loss或stop-loss-limit 。请注意，停止触发器是在服务器端使用最后交易价格而不是买价/卖价中点进行评估的。

Q4：是否有用于Kraken API集成测试的沙箱或演示环境？不存在官方沙箱。开发者必须使用零余额或最低资金的真实账户。 Kraken 建议对XTZ/USD等小批量货币对进行测试，以减少验证周期期间的财务风险。