KuCoin UTA API V1からV2へのアップグレードのお知らせ
機関およびプロフェッショナルな取引シナリオにおけるAPIの安定性、セキュリティ、標準化、拡張性に対する要件が高まる中、KuCoinはAPIシステムを包括的にアップグレードし、新しいAPI V2をリリースしました。
KuCoin UTA API V2は、業界標準のAPI設計原則とベストプラクティスに従い、API認証メカニズム、エラーコードシステム、API仕様、ドキュメント構造に体系的な改善を施しています。これらの強化により、開発者にはより標準的で一貫性のあるAPI統合体験を提供します。
このアップグレードは、既存のV1 APIの通常の使用に影響しません。V1 APIは引き続き利用可能であり、通常通り使用できます。今後、V2 APIが機能更新および保守の主要なAPIバージョンとなり、V1 APIは新機能の追加が行われなくなります。
1. アップグレードスケジュール
UTA API V2のアップグレードは、次のように実施予定です：
2026-08-27 10:00:00 (UTC)
2. アップグレードの影響
このアップグレードはUTA APIにのみ適用され、既存のV1 UTA APIの通常使用には影響しません。
- V1 APIは引き続き利用可能であり、既存のAPI統合をすぐに変更する必要はありません。
- V1 APIには新しい機能の更新は行われなくなります。新しい機能および今後のAPI最適化は、V2 APIに専念されます。
- ユーザーには、最新のAPI機能と仕様を活用するため、段階的にV2 APIへの移行を推奨します。詳細はAPIの概要をご参照ください。
3. V2 API の主要なアップデート
3.1 WebSocket認証のアップグレード
V2 APIは新しいAPI認証スキームを採用します。認証メカニズムはConnect Tokenから署名ベースの認証に変更されます。
新しい認証方法は、より標準化されたリクエスト検証メカニズムを提供します。
詳細な認証ルールと署名生成方法については、WebSocket イントロダクションをご参照ください。
3.2 APIエラーコード仕様のアップグレード
V2 APIは、APIエラーコードの統一かつ標準化された管理を実現するために、全新的なエラーコード仕様を採用します。
詳細なエラーコードおよびエラーメッセージについては、API エラーコードをご参照ください。
3.3 APIエンドポイントの更新
- すべてのUTA API V2エンドポイントのURLが更新され、すべてのエンドポイントがV2バージョンにアップグレードされました。
- 以下のAPIパラメーターはV1と比較して変更されています：
更新タイプ | エンドポイント | 更新情報 |
|---|---|---|
[修正] | UTA REST 口座通貨資産の取得（クラシック） |
|
[修正] | UTA REST サブアカウントの通貨資産を取得 |
|
[修正] | UTA REST Flex 振替 |
|
[修正] | UTA REST 入金アドレスの取得 |
|
[修正] | UTA REST 出金クォータの取得 |
|
[修正] | UTA REST 通貨の取得 |
|
[修正] | UTA REST 通貨の取得 |
|
[修正] | UTA REST 法定通貨価格の取得 |
|
[修正] | UTA REST Get Symbol |
|
[修正] | UTA REST 出金 |
|
[追加] | UTA REST 注文変更 および UTA Websocket 注文変更 |
|
[修正] | UTA REST 注文詳細の取得 および 注文履歴の取得 |
|
[修正] | UTA REST 取引履歴の取得 |
fillType: すべての取引タイプを照会できるようにサポート |
[修正] | UTA Websocket 資金調達料 |
|
[追加] | UTA Websocket すべての資金調達料率 |
|
[追加] | UTA REST 現在の資金調達率を取得 |
|
[修正] | UTA REST インデックス価格の取得 |
|
[修正] | UTA REST 金利インデックスの取得 |
|
[修正] | UTA REST Klinesの取得 |
|
3.4 V1およびV2のレート制限ルール
- V1およびV2 APIを通じて行われるリクエストは、対応するレート制限プールのクォータを合計して消費します。
- V2へのアップグレードでは、V1とは独立した追加のレート制限クォータは提供されません。
- ユーザーは、実際のAPI利用状況に応じて、V1およびV2 APIのリクエスト頻度を適切に管理する必要があります。
4. APIドキュメントの内容更新
ユーザーが異なるAPIバージョンを区別できるよう、APIドキュメントの構造も更新しました。
4.1 V1 API
既存のV1 APIエンドポイントのコンテンツは「廃止されたエンドポイント」コンテンツに移動されました。 Abandoned Endpoints のコンテンツをご参照ください。
V1 APIは引き続き使用可能です。V1 APIの表示または使用を継続する場合は、このコンテンツ内の関連エンドポイントドキュメントをご参照ください。
4.2 V2 API
新しいV2 APIエンドポイントが、対応するAPI製品およびビジネスカテゴリのコンテンツに追加されました。
今後、APIドキュメントを参照する際は、対応するV2 APIエンドポイントとドキュメントを優先することをお勧めします。
5. V2 API 移行ガイド
5.1 新規ユーザー
初めてKuCoin APIと統合する場合、API統合ソリューションとしてUTAモード＋UTA API V2の使用をお勧めします。
UTA RESTおよびUTA WebSocketのドキュメントを直接参照できます。
5.2 既存ユーザー向け移行ガイド
既存のユーザーは、ビジネス要件に応じて既存のエンドポイントを段階的にV2に移行できます。移行プロセス中は、以下の手順に従うことを推奨します：
- 新しい認証方法に適応する
WebSocket V2プライベートチャンネルと署名認証に基づく取引認証を実装してください。
- バッチエンドポイントの移行
2026年8月27日以降に公開されたChangelogのエントリを確認し、Changelogに記載されているエンドポイントを特定できます。
Changelogに記載されていないエンドポイントについては、既存のビジネスロジックに変更は必要ありません。V1 API URLを対応するV2 API URLに直接置き換えることで、一括移行を完了できます。
- 特定のエンドポイントを移行する
2026年8月27日以降に公開されたChangelogに記載されているエンドポイントについて、V2 APIにはV1と比較して特定の変更が加えられています。
変更履歴に記載された変更に従って統合を調整するか、直接対応するV2 APIドキュメントを参照して移行を完了してください。
- V2エラーコードに適応する
V2 APIは新しいエラーコード仕様を導入し、より標準的で具体的なエラーメッセージを提供します。
既存のシステムがV1エラーコードに基づいてプログラム処理を行っている場合、V2エラーコードを適切にサポートするために実装を更新する必要があります。
詳細については、API エラーコードをご参照ください。
6. 移行タイムライン
既存のV1 APIユーザーは、できるだけ早くV2への移行を開始することをお勧めします。
V2のリリース後もV1 APIは引き続き利用可能ですが、V1は新しい機能の追加やエンドポイントの最適化を受けなくなります。今後の新しいAPI機能は主にV2を通じて提供されます。
V1 APIは2026年12月31日に非推奨となり、サービスを終了する予定です。具体的なサービス終了日および対応については、今後の公式アナウンスを参照してください。
APIについての詳細は、公式チャネルへご参加ください
KuCoin API Telegramコミュニティ
また、メールにてお問い合わせいただけます：[email protected]
免責事項: このページは、お客様の便宜のためにAI技術を使用して翻訳されています。最も正確な情報については、元の英語版を参照してください。
で私たちをみつけて:
X (Twitter) | Telegram | Reddit
今すぐCoinCarpアプリをダウンロード: https://www.coincarp.com/app/
