ボットを取引するために KuCoin API を使用するにはどうすればよいですか? (開発者ツール)

認証メカニズム

1. KuCoin API では、すべてのプライベート エンドポイントに対して HMAC-SHA256 署名の生成が必要です。署名は、タイムスタンプ、HTTP メソッド、エンドポイント パス、およびオプションのリクエスト本文の連結から派生します。

2. 各リクエストには、 KC-API-KEY 、 KC-API-TIMESTAMP 、およびKC-API-SIGNの 3 つのヘッダーが含まれている必要があります。タイムスタンプは KuCoin のサーバー時間から 5 秒以内である必要があります。

3. API キー ペアは、API Management の KuCoin ユーザー インターフェイスから生成する必要があります。権限は「取引」「口座」「出金」など必要な範囲のみに限定してください。

4. 秘密鍵は回線を介して送信されることはありません。これらはボット環境に対してローカルのままであり、発信リクエストに署名するためにのみ使用されます。

5. IP ホワイトリスト登録は、新しく作成された API キーに対してデフォルトで適用されます。開発者は、401 不正応答を回避するために、信頼できる IP を事前に登録する必要があります。

注文ライフサイクル管理

1. 注文を出すには、シンボル、サイド (買い/売り)、タイプ (指値/市場/ストップ)、サイズまたは価格などのパラメーターを指定したPOST /api/v1/ordersエンドポイントを使用します。

2. 成行注文ではサイズとサイドのみが必要です。指値注文では価格とサイズの両方が要求されます。ストップ注文では、stopPrice や stop などの追加フィールドが導入されます。

3. アクティブな注文はGET /api/v1/orders?status=active 経由でクエリでき、注文 ID、ステータス、注文済みサイズ、残りのサイズを含むページ分割された結果が返されます。

4. 単一の注文をキャンセルするにはDELETE /api/v1/orders/{order-id}を使用しますが、一括キャンセルにはDELETE /api/v1/orders?symbol=BTC-USDTを使用して複数の ID を対象にします。

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}を通じてサポートされており、クライアントはトピックと privateChannel フラグを含む JSON メッセージを使用してサブスクライブします。

3. 過去の kline データはGET /api/v1/market/candles?symbol=ETH-USDT&interval=1min&startAt=1698777600&endAt=1698781200で取得され、1 分から 1 日までの間隔をサポートします。

4. シンボルのリストと取引ペアの詳細は、baseCurrency、quoteCurrency、priceIncrement、minSize 制約を含め、 GET /api/v2/symbolsで入手できます。

5. 深度スナップショットには、デルタ同期を可能にするシーケンス番号が含まれています。クライアントは、更新の欠落や注文帳の状態が古くならないように、シーケンスの連続性を検証する必要があります。

レート制限とエラー処理

1. KuCoin は厳格なレート制限を適用します。標準 API キーでは、パブリック エンドポイントの場合は 1 秒あたり 100 リクエスト、プライベート エンドポイントの場合は 20 リクエスト/秒です。

2. 制限を超えると、必須のバックオフ期間をミリ秒単位で示す Retry-After ヘッダーを含む HTTP 429 応答がトリガーされます。

3. 一般的なエラー コードには、400 (無効なパラメータ)、401 (認証失敗)、403 (不十分な権限)、および 404 (シンボルが見つかりません) などがあります。

4. すべてのエラー応答には、コード、メッセージ、および場合によっては提案フィールドを含む標準化された JSON 本文が含まれます (例: {'code':'400100','msg':'Invalid signal'}) 。

5. 重複した送信を防ぐために、注文には冪等キーが必要です。 KC-API-REQ-IDヘッダーで送信される一意の UUID である必要があります。

よくある質問

Q: 複数のボット インスタンスで同じ API キーを使用できますか? A: はい、ただしレート制限を超える同時リクエストによりスロットルが発生します。共有キーも侵害された場合にセキュリティ リスクを高めます。

Q: タイムスタンプとシークレットが正しいにもかかわらず、署名されたリクエストが「無効な署名」を返すのはなぜですか? A: ほとんどの場合、文字列の正規化が正しくないことが原因です。コンポーネント間の改行文字の欠落、リクエスト本文の不適切な UTF-8 エンコード、またはプリハッシュ文字列の末尾の空白です。

Q: WebSocket 接続は状態の再同期による再接続をサポートしていますか? A: はい、KuCoin はすべてのメッセージにシーケンス番号を提供します。再接続時に、クライアントは新しいスナップショットを要求し、最後に処理されたものよりもシーケンス番号が小さいメッセージをすべて破棄する必要があります。

Q: 証拠金取引または先物取引は同じ REST API 経由でサポートされていますか? A: いいえ。証拠金と先物操作には別個の API ベース ( https://api.kucoin.com/api/v1/marginおよびhttps://futures.kucoin.com/api/v1/contracts/active ) が必要で、それぞれに個別の認証とエンドポイントが必要です。