如何使用KuCoin API进行交易机器人？ （开发者工具）

认证机制

1. KuCoin API需要为所有私有端点生成HMAC-SHA256签名。签名源自时间戳、HTTP 方法、端点路径和可选请求正文的串联。

2. 每个请求必须包含三个标头： KC-API-KEY 、 KC-API-TIMESTAMP和KC-API-SIGN 。时间戳必须在KuCoin服务器时间的5秒以内。

3. API密钥对必须在KuCoin用户界面的API管理下生成。权限应仅限于必要的范围，例如“交易”、“账户”或“提款”。

4. 密钥绝不会通过线路传输。它们保留在机器人环境本地，仅用于签署传出请求。

5. 默认情况下，对新创建的 API 密钥强制执行 IP 白名单。开发者必须提前注册可信IP，避免出现401未授权响应。

订单生命周期管理

1. 下订单使用POST /api/v1/orders端点，其中包含交易品种、边（买入/卖出）、类型（限价/市价/止损）以及大小或价格等参数。

2、市价单只需要尺寸和边长；限价订单同时规定价格和尺寸。止损单引入了额外的字段，例如 stopPrice 和 stop。

3. 活跃订单可以通过GET /api/v1/orders?status=active查询，返回包含订单 ID、状态、已成交尺寸和剩余尺寸的分页结果。

4. 取消单个订单使用DELETE /api/v1/orders/{order-id} ，批量取消针对多个 ID 使用DELETE /api/v1/orders?symbol=BTC-USDT 。

5. 通过 WebSocket 源或轮询GET /api/v1/fills端点来跟踪订单执行状态，该端点返回交易历史记录，包括费用金额和时间戳。

市场数据整合

1. 通过GET /api/v1/market/orderbook/level2_20?symbol=BTC-USDT检索公共股票数据，提供前 20 个买入/卖出水平的价格、规模和序列号。

2. 通过 KuCoin 的 WebSocket v2 通道/market/ticker:{symbol}支持实时更新，客户端使用包含 topic 和 privateChannel 标志的 JSON 消息进行订阅。

3. 历史K线数据通过GET /api/v1/market/candles?symbol=ETH-USDT&interval=1min&startAt=1698777600&endAt=1698781200获取，支持间隔从1分钟到1天。

4. 交易品种列表和交易对详细信息可在GET /api/v2/symbols获取，包括 baseCurrency、quoteCurrency、priceIncrement 和 minSize 约束。

5. 深度快照包括启用增量同步的序列号。客户必须验证序列连续性，以避免错过更新或过时的订单簿状态。

速率限制和错误处理

1. KuCoin执行严格的速率限制：标准API密钥上公共端点每秒100个请求，私有端点每秒20个请求。

2. 超出限制会触发 HTTP 429 响应，其中 Retry-After 标头指示强制退避持续时间（以毫秒为单位）。

3. 常见错误码包括400（参数无效）、401（认证失败）、403（权限不足）、404（符号未找到）。

4. 所有错误响应均包含标准化 JSON 主体，其中包含代码、消息，有时还包含建议字段，例如{'code':'400100','msg':'Invalid symbol'} 。

5、下单需要幂等密钥，防止重复提交；它们必须是在KC-API-REQ-ID标头中发送的唯一 UUID。

常见问题解答

问：我可以在多个机器人实例中使用相同的 API 密钥吗？ A：可以，但是并发请求超过速率限制会导致限流。如果共享密钥遭到泄露，也会增加安全风险。

问：即使时间戳和密码正确，为什么我的签名请求仍返回“无效签名”？答：最常见的原因是字符串规范化不正确——组件之间缺少换行符、请求正文的 UTF-8 编码不正确或预哈希字符串中的尾随空格。

问：WebSocket 连接是否支持状态重新同步的重新连接？答：是的，KuCoin在每条消息中都会提供序列号。重新连接后，客户端应请求新快照并丢弃序列号低于上次处理的消息的任何消息。

问：保证金或期货交易是否通过相同的 REST API 支持？答：不需要。保证金和期货操作需要单独的 API 库： https://api.kucoin.com/api/v1/margin和https://futures.kucoin.com/api/v1/contracts/active ，每个库都有不同的身份验证和端点。