KuCoin Margin API Upgrade Announcement

07/04/2025, 14:33:02

Custom

Dear KuCoin Users,

To provide users with a better trading environment and optimize the trading experience, KuCoin's Leverage API is undergoing a high-frequency migration and upgrade. This migration will be conducted in multiple batches and is expected to be completed by the end of March 2026.

1. Scope of Migration:

For users who have enabled Margin, if there are no Margin positions or assets during the migration, it will not impact you.

2. Impact of Migration:

     2.1 Non-API Users (C-end users)

  • The user experience on Web/App will remain unchanged before and after migration.

     2.2 API Users

  • This migration will have a certain impact on the API interface calling method and asset status display. This migration will be notified in batches. Please perform the corresponding operations in time after receiving the email notification. The system will migrate 7 days after the email is sent. (To reduce the impact, you can switch to high-frequency API in advance).

3. Migration Process:

Step 1: Manually clean up low-frequency orders

a. Users need to cancel orders placed by low-frequency API and C-end (Web/App) by themselves;

b. High-frequency orders do not need to be canceled;

  • If you do not cancel actively, the system will force the order to be cancelled during the migration process (including ordinary and advanced orders).

  • If you do not confirm your order status, please contact customer service for consultation.

Step 2: Manually transfer low-frequency assets (API users)

a. Users need to manually transfer low-frequency account assets to high-frequency accounts and switch to the new API interface (see api-doc for details).

b. Get Transfer Quotas - KUCOIN API At this time, the assets in the C-end (Web and App) are displayed as "FROZEN", and high-frequency orders cannot be operated.

Step 3: Start Migration

*Steps 1 and 2 are not mandatory, but once the migration is executed, the system will automatically cancel low-frequency orders and transfer low-frequency assets to high-frequency accounts.

Important Notes:

  1. Account temporary unavailability (both C-end users and API users will be affected);

During the migration execution, user accounts will be temporarily unavailable for 2-3 minutes, involving asset query, trading and transfer functions. Please arrange operations in advance to avoid affecting transactions.

  1. Forced cancellation of low-frequency orders;

If the user does not cancel the low-frequency order in advance, the system will forcefully cancel the unfulfilled low-frequency ordinary orders and advanced orders during the migration process.

  1. Assets are displayed as "frozen" for a short time;

During the migration preparation phase, high-frequency assets may be displayed as "frozen" in the old interface, and will return to normal after the migration is completed.

  1. Interface compatibility tips;

The old interface will no longer support high-frequency account-related queries. Be sure to complete the switch in advance, otherwise an exception may be returned.

  1. Official migration will occur 7 days after email notification;

The official migration will commence 7 days after the email notification is sent. Users are advised to monitor their inboxes closely and complete all necessary preparations before the migration date to ensure a smooth transition and avoid service interruptions.

Detailed Migration Content:

Asset Queries

  •  We recommend using the new API interface for asset queries:

    • Cross margin account asset query: /api/v3/margin/accounts

    • Isolated margin account asset query: /api/v3/isolated/accounts

  •  After migration, asset data before and after migration will remain consistent. Once the migration is completed, both margin, margin_v2, and ALL queries will return consistent results (similarly for isolated accounts).

Note: The old asset query interfaces (/api/v1/margin/account for cross-margin and /v1/isolated/accounts for isolated margin) will remain available after migration, but high-frequency assets will be shown as "Frozen" for users who have not migrated yet.

Transaction Ledger Queries

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

  • The ledger can be queried for both high-frequency and low-frequency accounts before and after migration, with the same time range as before.

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

  • This only supports querying high-frequency account transactions, with a limited time range of the last three days.

Users can choose the interface based on their needs.

Transfers

  •  The transfer interface remains the same. The previous interface can still be used for transfers between high-frequency and low-frequency accounts.

    • Before Migration: Transfers between high-frequency and low-frequency accounts within the same user are supported.

    • After Migration: margin and margin_v2 will be treated as the same account, and transfers between these two accounts will no longer be supported (similarly for isolated margin).

Historical Order Queries

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

  • The historical orders can be queried for both high-frequency and low-frequency orders, with the same time range.

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

  • This only supports querying high-frequency orders and can only return data for the last three days. Users can choose according to their needs.

Order Placement/Order Cancellation/Active Order Query

1. V1 Interface: Supports placing, canceling, and querying active low-frequency orders.

2. V3 Interface: Supports placing, canceling, and querying active high-frequency orders.

High-frequency and low-frequency orders are not compatible with each other, including take-profit and stop-loss functions. Users should use the corresponding interface based on the order type.

Migration Interface Changes:

  • Note: It is recommended to clarify the interface changes involved before and after the migration in advance to avoid affecting usage.

Action

Before Migration Interface

After Migration Interface

Order Placement

Regular Order: /api/v1/margin/order

Stop Order: /api/v1/stop-order

Regular Order: /api/v3/hf/margin/order Stop Order: /api/v3/hf/margin/stop-order OCO: /api/v3/hf/margin/oco-order

Order Cancellation

By orderId: /api/v1/orders/{orderId}

By clientOid: /api/v1/order/client-order/{clientOid}

Bulk Cancellation: /api/v1/orders

By orderId: /api/v3/hf/margin/orders/{orderId}?symbol={symbol}

By clientOid: /api/v3/hf/margin/orders/client-order/{clientOid}?symbol={symbol}

Bulk Cancellation: /api/v3/hf/margin/orders?symbol={symbol}&tradeType={tradeType}

Active Order Query

/api/v1/orders?status=active

/api/v3/hf/margin/orders/active?tradeType={tradeType}&symbol={symbol} Query active trading pairs: /api/v3/hf/margin/order/active/symbols

Risk Warning

Margin trading refers to the practice of borrowing funds with a relatively lower amount of capital to trade financial assets and obtain bigger profits. However, due to market risks, price fluctuations, and other factors, you are strongly recommended to be prudent about your investment actions, adopt an appropriate leverage level for margin trading, and properly stop your losses in a timely manner. KuCoin assumes no responsibility for any losses arising from the trade.

Thanks for your support!

The KuCoin Team

Find The Next Crypto Gem On KuCoin!

Sign up on KuCoin now! >>>

Download the KuCoin App >>>

Follow us on X (Twitter) >>>

Join us on Telegram >>>

Join the KuCoin Global Communities >>>