KuCoin 証拠金APIアップグレードのお知らせ

KuCoin 証拠金APIアップグレードのお知らせ

2025/07/04 6:33:02

カスタム画像

親愛なるKuCoinユーザーの皆様

ユーザーの皆様により良い取引環境を提供し、取引体験を最適化するため、KuCoinの証拠金APIは高頻度の移行とアップグレードを実施しています。この移行は複数のバッチに分けて行われ、2025年末までに完了する予定です。

1. 移行の範囲:

証拠金を有効化しているユーザーで、移行期間中に証拠金ポジションや資産がない場合、影響はありません。

2. 移行の影響:

2.1 非APIユーザー(Cエンドユーザー)

  • Web/Appでのユーザー体験は、移行前後で変更がありません。

2.2 APIユーザー

  • この移行により、APIインターフェースの呼び出し方法や資産ステータス表示に一定の影響があります。この移行はバッチで通知されます。通知メールを受信後、対応する操作を速やかに行ってください。システムはメール送信後7日間で移行を実施します。(影響を軽減するために、高頻度APIへの事前切り替えを推奨します)。

3. 移行のプロセス:

ステップ1: 低頻度注文の手動清算

a. ユーザーは、低頻度APIおよびCエンド(Web/App)による注文を自身でキャンセルする必要があります;

b. 高頻度注文はキャンセルする必要はありません;

  • ユーザーが積極的にキャンセルしない場合、移行プロセス中にシステムが注文を強制的にキャンセルします(通常注文および高度注文を含む)。

  • 注文ステータスを確認できない場合は、カスタマーサービスまでお問い合わせください。

ステップ2: 低頻度資産の手動転送(APIユーザー)

a. ユーザーは低頻度アカウントの資産を手動で高頻度アカウントへ転送し、新しいAPIインターフェースに切り替える必要があります(詳細は api-doc をご参照ください)。

b.転送クォータを取得する - KUCOIN API現在、Cエンド(Webおよびアプリ)の資産が「FROZEN」と表示されており、高頻度注文の操作ができません。

ステップ 3: 移行を開始

*ステップ1と2は必須ではありませんが、移行が実行されると、システムは低頻度注文を自動的にキャンセルし、低頻度資産を高頻度アカウントに移行します。

重要な注意事項:

  1. アカウントの一時的な利用不可(CエンドユーザーおよびAPIユーザーが影響を受けます);

移行実行中、ユーザーアカウントは2~3分間一時的に利用できなくなり、資産クエリ、取引、および送金機能が影響を受けます。取引に影響を与えないよう、事前に操作を調整してください。

  1. 低頻度注文の強制キャンセル;

ユーザーが低頻度注文を事前にキャンセルしない場合、移行プロセス中にシステムが未完了の低頻度通常注文および高度注文を強制的にキャンセルします。

  1. 資産が短時間「FROZEN」と表示;

移行準備段階では、古いインターフェースで高頻度資産が「FROZEN」と表示される場合がありますが、移行完了後、正常に戻ります。

  1. インターフェース互換性に関する注意点;

古いインターフェースでは高頻度アカウント関連のクエリをサポートしなくなります。事前に切り替えを完了してください。切り替えを完了しない場合、例外が返される可能性があります。

  1. 公式移行はメール通知後7日間で実施;

公式移行はメール通知送信後7日間で開始されます。移行日までにすべての必要な準備を整え、サービス中断を避けるためにメール受信ボックスを注意深く監視してください。

移行の詳細内容:

資産クエリ

  • 資産クエリには新しいAPIインターフェースの使用を推奨します:

    • クロス証拠金アカウント資産クエリ: /api/v3/margin/accounts

    • 分離証拠金アカウント資産クエリ: /api/v3/isolated/accounts

  • 移行後、移行前後の資産データは一貫性を保ちます。移行完了後は、証拠金、margin_v2、およびALLクエリが一貫した結果を返します(分離アカウントも同様)。

注意:旧資産クエリインターフェース(クロスマージン用: /api/v1/margin/account 、アイソレートマージン用: /v1/isolated/accounts )は移行後も利用可能ですが、移行していないユーザーに関しては、高頻度資産が「凍結」として表示されます。

取引台帳クエリ

1. V1 Interface: /api/v1/accounts/ledgers

  • 移行前後の高頻度および低頻度アカウントの台帳クエリが可能で、以前と同じタイムレンジで対応します。

2. V3 Interface: /api/v3/hf/margin/account/ledgers

  • こちらは高頻度アカウントの取引クエリのみをサポートし、直近3日間のタイムレンジに限定されます。

ユーザーはニーズに応じてインターフェースを選択できます。

送金

  • 送金インターフェースは変更ありません。以前のインターフェースを利用して、高頻度アカウントと低頻度アカウント間の送金が可能です。

    • 移行前: 同一ユーザー内での高頻度アカウントと低頻度アカウント間の送金がサポートされます。

    • 移行後: 証拠金(margin)と証拠金_v2(margin_v2)は同一アカウントとして扱われ、これらの間の送金はサポートされなくなります(アイソレートマージンも同様です)。

履歴注文クエリ

1. V1 Interface: /api/v1/orders?status=done

  • 移行前後の高頻度および低頻度注文履歴クエリが可能で、以前と同じタイムレンジで対応します。

2. V3 Interface: /api/v3/hf/margin/orders/done

  • こちらは高頻度注文履歴のクエリのみをサポートし、直近3日間のデータのみ返します。ユーザーはニーズに応じて選択できます。

注文の配置/キャンセル/アクティブ注文クエリ

1. V1 Interface: 低頻度注文の配置、キャンセルおよびアクティブ注文のクエリをサポートします。

2. V3 Interface: 高頻度注文の配置、キャンセルおよびアクティブ注文のクエリをサポートします。

高頻度注文と低頻度注文は互換性がなく、テイクプロフィットおよびストップロス機能も含まれません。注文タイプに応じて適切なインターフェースをご利用ください。

移行インターフェースの変更:

  • 注意: 移行前後で発生するインターフェース変更を事前に明確にしておくことをおすすめいたします。これにより利用への影響を回避できます。

アクション

移行前インターフェース

移行後インターフェース

注文の配置

通常注文: /api/v1/margin/order

ストップ注文: /api/v1/stop-order

通常注文: /api/v3/hf/margin/order ストップ注文: /api/v3/hf/margin/stop-order OCO: /api/v3/hf/margin/oco-order

注文キャンセル

注文IDでキャンセル: /api/v1/orders/{orderId}

クライアントOIDでキャンセル: /api/v1/order/client-order/{clientOid}

一括キャンセル: /api/v1/orders

注文IDでキャンセル: /api/v3/hf/margin/orders/{orderId}?symbol={symbol}

クライアントOIDでキャンセル: /api/v3/hf/margin/orders/client-order/{clientOid}?symbol={symbol}

一括キャンセル: /api/v3/hf/margin/orders?symbol={symbol}&tradeType={tradeType}

アクティブ注文クエリ

/api/v1/orders?status=active

/api/v3/hf/margin/orders/active?tradeType={tradeType}&symbol={symbol} アクティブな取引ペアのクエリ: /api/v3/hf/margin/order/active/symbols


リスク警告

証拠金取引とは、比較的少ない資本を元手に資金を借りて金融資産を取引し、より大きな利益を得る取引方法を指します。ただし、市場リスクや価格変動などの要因により損失が発生する可能性があります。証拠金取引では慎重な投資判断を行い、適切なレバレッジレベルを採用し、適切なタイミングで損切りを実施することを強くお勧めします。  KuCoin  は、取引により発生したいかなる損失に対しても責任を負いません。

ご支援いただきありがとうございます!

KuCoinチーム

次の暗号資産の原石をKuCoinで見つけましょう!

今すぐKuCoinでサインアップ! >>>

KuCoinアプリをダウンロード >>>

X (Twitter) でフォロー >>>

Telegramで参加 >>>

KuCoinグローバルコミュニティに参加 >>>

免責事項: このページは、お客様の便宜のためにAI技術(GPT活用)を使用して翻訳されています。最も正確な情報については、元の英語版を参照してください。