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

04/07/2025 14:33:02

カスタム

KuCoinご利用のお客様へ

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

1. 移行の範囲：

マージンを有効化しているユーザーの場合、移行中にマージン保有資産または資産がなければ、影響はありません。

2. 移行の影響：

     2.1 API非利用者（C端ユーザー）

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

     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およびアプリ）の資産は「凍結中」と表示され、高頻度注文は操作できません。

ステップ3：移行を開始

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

重要な注意点：

  1. 口座が一時的に利用できません（CエンドユーザーおよびAPIユーザーの両方に影響があります）；

移行実行中、ユーザーの口座は2〜3分間一時的に利用できなくなり、資産照会、取引、振替機能が利用できません。取引に影響が出ないよう、あらかじめ操作を計画してください。

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

ユーザーが低頻度注文を事前にキャンセルしない場合、システムは移行中に未約定の低頻度一般注文および高度な注文を強制的にキャンセルします。

  1. アセットは一時的に「凍結中」として表示されます；

移行準備段階では、高頻度資産が旧インターフェースで「凍結」として表示される場合があります。移行が完了すると通常に戻ります。

  1. インターフェースの互換性に関するヒント；

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

  1. 公式な移行は、メール通知から7日後に実施されます；

公式な移行は、メール通知が送信されてから7日後に開始されます。ユーザーは受信トレイをこまめに確認し、移行日までに必要な準備を完了して、スムーズな移行を確保し、サービスの中断を避けてください。

詳細な移行コンテンツ：

アセット照会

  •  資産照会には、新しいAPIインターフェースの使用をお勧めします。

    • クロスマージン口座資産照会：/api/v3/margin/accounts

    • 分離マージン口座資産照会：/api/v3/isolated/accounts

  •  移行後、移行前の資産データと移行後の資産データは一貫性を保ちます。移行が完了すると、margin、margin_v2、およびすべてのクエリが一貫した結果を返します（孤立口座についても同様です）。

注：古いアセット照会インターフェース（クロスマージン用 /api/v1/margin/account、分離マージン用 /v1/isolated/accounts）は、移行後も利用可能ですが、移行尚未のユーザーには高頻度アセットが「凍結中」と表示されます。

取引明細の照会

1. V1インターフェース：/api/v1/accounts/ledgers

  • 移行前後において、高頻度および低頻度の口座について、以前と同じ時間範囲で台帳を照会できます。

2. V3インターフェース：/api/v3/hf/margin/account/ledgers

  • これは高頻度の口座取引の照会のみをサポートしており、利用可能な期間は過去3日間のみです。

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

振替

  •  振替インターフェースは変更ありません。以前のインターフェースは、高頻度口座と低頻度口座間の振替に引き続き使用できます。

    • 移行前：同じユーザー内の高頻度口座と低頻度口座間の振替が可能です。

    • 移行後：margin と margin_v2 は同じ口座として扱われ、これらの間の振替はサポートされなくなります（分離マージンについても同様です）。

履歴注文照会

1. V1インターフェース：/api/v1/orders?status=done

  • 履歴注文は、高頻度および低頻度の注文ともに、同じ時間範囲で照会できます。

2. V3インターフェース：/api/v3/hf/margin/orders/done

  • これは高頻度注文の照会のみをサポートし、過去3日間のデータのみを返します。ユーザーは自身のニーズに応じて選択できます。

注文の発注／注文のキャンセル／アクティブ注文の照会

1. V1インターフェース：低頻度注文の注文、キャンセル、およびアクティブな注文の照会をサポートします。

2. V3インターフェース：アクティブな高頻度注文の注文、キャンセル、照会をサポートします。

高頻度注文と低頻度注文は互換性がなく、利確および損切機能も含まれます。ユーザーは注文タイプに応じて対応するインターフェースを使用してください。

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

  • 注：利用への影響を避けるため、移行前後のインターフェース変更内容を事前に明確にしておくことを推奨します。

アクション

移行前のインターフェース

移行インターフェース後

注文の発注

通常注文：/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活用)を使用して翻訳されています。最も正確な情報については、元の英語版を参照してください。