Change Log

WARNING

The Pro API is currently in beta testing and should not be used in production trading environments.

2026.01.27

[Spot Modify] Get Apikey Info endpoint: Added siteType response parameter.

2026.01.17

[Modify]

#	Pro API	Endpoint	Change Dimension	Change Details
1	REST	OrderBook	Spot / Futures	Spot: `sequence` changed from String → Number; Futures: `price` / `size` changed from Number → String (incl. RPI).
2	REST	Get Trades	Spot / Futures	Spot: `sequence` changed from String → Number; Futures: `size` changed from Number → String; Futures: removed response fields `makerOrderId`, `takerOrderId`, `contractId`; Futures: response JSON structure adjusted to match Spot.
3	WS	Trade	Spot	Spot: `E` changed from String → Number.
4	REST	Get Klines	Spot / Futures	Spot: array order adjusted to Open → High → Low → Close; Futures: `Start time` granularity changed to seconds, and type changed from String → Number.
5	WS	Kline	Futures	Futures: added field `S` (start) to indicate whether it is the latest Kline.
6	WS	Balance	UTA	UTA: added fields `l` (lowercase L) and `U`.
7	WS	Execution	Futures / Enum	Futures: `E` changed from String → Number; Enum: `S` values unified to uppercase BUY / SELL; `oT` values unified to uppercase MARKET / LIMIT.
8	WS	Order	UTA	UTA: `os` changed from String → Number.
9	REST	Get Order Details Get Open List Get Order History	UTA / Futures	UTA: `status` changed from String → Number; Futures: fixed issue where `avgPrice` could be negative in some scenarios.
10.1	REST	Get Account (Classic) Get Sub Account Get Transfer Quotas Flex Transfer Get Account Ledger	Parameter	`AccountType` enum: `TRADING` changed to `SPOT` (updated in both request and response).
10.2	WS	Balance	Parameter	`AccountType` enum: `TRADING` changed to `SPOT` (updated in both request and response).
11	REST	Get Account Ledger	Futures / Enum	Futures: `id` changed from Number → String; Futures: `balance` / `amount` changed from Number → String; Enum: `direction` values unified to uppercase IN / OUT.
12.1	REST	Add Deposit Address	URL	URL unified to: `POST /api/ua/v1/asset/deposit/address`.
12.2	REST	Get Deposit Address	URL	URL unified to: `GET /api/ua/v1/asset/deposit/address`.
12.3	REST	Batch Place Order (Classic)	URL	URL changed to: `POST /api/ua/v1/{accountMode}/order/place-batch`.

Note

Add Deposit Address will not be released in this phase.

Get Deposit Address will return a deposit address; when both currency and chain are provided, the address will be created if it does not exist.

2026.01.16

[Modify] Private Endpoint Rate Limit Weight

#	Pro API	Endpoint	Change Dimension	Change Details
1	REST	Place Order	api-rate-limit-weight	Each request now consumes a rate limit weight of 1.
2	REST	Cancel Order	api-rate-limit-weight	Each request now consumes a rate limit weight of 1.

2026.01.12

[Modify]

Category	Endpoint	URL	Changed Fields
Pro REST	Get Ticker	GET `/api/ua/v1/market/ticker`	`ts` (standardized to nanoseconds, ns)
Pro REST	Get Trade	GET `/api/ua/v1/market/trade`	`ts` (standardized to nanoseconds, ns)
Pro REST	Get Account Ledger	GET `/api/ua/v1/account/ledger`	`ts` (standardized to nanoseconds, ns)
Pro REST	Get Order Details	GET `/api/ua/v1/{accountMode}/order/detail`	`orderTime` / `updatedTime` (standardized to nanoseconds, ns)
Pro REST	Get Open Order List	GET `/api/ua/v1/{accountMode}/order/open-list`	`orderTime` / `updatedTime` (standardized to nanoseconds, ns)
Pro REST	Get Order History	GET `/api/ua/v1/{accountMode}/order/history`	`orderTime` / `updatedTime` (standardized to nanoseconds, ns)
Pro REST	Get Trade History	GET `/api/ua/v1/{accountMode}/order/execution`	`executionTime` (standardized to nanoseconds, ns)
Pro REST	Get Positions History	GET `/api/ua/v1/position/history`	`closingTime` / `creationTime` (standardized to nanoseconds, ns)
Pro REST	Get Position List	GET `/api/ua/v1/{accountMode}/position/open-list`	`closingTime` / `creationTime` (standardized to nanoseconds, ns)
Pro WebSocket	Depth (snapshot / increment)	WS	`M` (standardized to nanoseconds, ns)
Pro WebSocket	Ticker	WS	`M` (standardized to nanoseconds, ns)
Pro WebSocket	Trade	WS	`M` (standardized to nanoseconds, ns)
Pro WebSocket	Kline (SPOT / FUTURES)	WS	`O` (startAt) / `C` (endAt) (standardized to seconds, 10 digits)
Pro REST	Get Symbol (Instrument)	GET `/api/ua/v1/market/instrument`	`unitSize` (inverse: -1 → 1; 1 contract = 1 USD)
Pro REST	Get Symbol (Instrument)	GET `/api/ua/v1/market/instrument`	`name` / `displayBaseCurrency` (added for Futures; multilingual compatibility)

2025.01.02

WARNING

The RPI feature is currently under internal development and testing, and has not been officially released for public use. In Phase 1, it supports Futures only (Spot and Margin are not supported). RPI currently supports Pro API Classic accounts only; UTA is not supported.

[Modify] Place Order, Batch Place Order request parameter "timeInForce" add an "RPI" enumeration value.

[Modify] Get Order Details , Get Open Order List, Get Order History response parameter "timeInForce" add an "RPI" enumeration value.

[Modify] Get Trades add "isRpiTrade" response parameter.

[Modify] Trade Push add "rpi" response parameter.

[Modify] Get OrderBook, Orderbook Push add "rpiFilter" request paramter and add RPI response parameter.

2025.12.31

[Modify]

Pro API	Change Description
Pro API WebSocket Ticker	Changed all price-related response fields (b, a, l) from Number to String. Updated the description of the M field.
Pro API WebSocket Orderbook	1. Added support for Depth 1 order book data. 2. Aligned snapshot push format with incremental updates: • Removed E; • Added C and O; • For snapshots, O = C. 3. Updated Futures order book structure from one-dimensional to two-dimensional arrays, unified with Spot. 4. Changed quantity field type from Number to String.
Pro API WebSocket Kline	1. Changed Start time and End time from String to Number, standardized to seconds. 2. Changed price and quantity (contracts) from Number to String.
Pro API RESTful Get Orderbook	Changed the Futures sequence field type from String to Long.

2025.12.30

[Modify]

Pro API WebSocket	Account & Trade Type Support
Order	Classic accounts: Supports all trade types. UTA accounts: Supports Spot and Futures trade types. Margin (Isolated & Cross) is expected to be supported in Q1–Q2 next year.
Position	Classic accounts: Supports Futures trade type. UTA accounts: Supports Futures trade types. Margin (Isolated & Cross) is expected to be supported in Q1–Q2 next year.
Balance	Classic accounts: Supports all trade types. UTA accounts: Supports Spot and Futures trade types. Margin (Isolated & Cross) is expected to be supported in Q1–Q2 next year.
Execution	Classic accounts: Supports all trade types. UTA accounts: Currently not supported.

2025.12.26

[Futures Modify] Get Symbol, Get All Symbols added field "displaySymbol" and "displayBaseCurrency"

2025.12.15

[Margin Add] Get Market Available Inventory

2025.12.10

[Futures Modify] Get Account - Futures added field "availableMargin"

2025.11.24

Below endpoints added effectiveFundingRateCycleStartTime and currentFundingRateGranularity response parameter.

[Futures Modify] Get Symbol

[Futures Modify] Get All Symbols

2025.11.21

[Add] Get Kumining

2025.11.17

[Modify] WebSocket Ticker V2 Added descriptions for the sn and sequence fields to the Futures TickerV2 WebSocket topic.

2025.11.14

[Add] Broker Fast API Service Verify A Token (WIP)

[Modify] Get Apikey Info Added new fields in the response "parentUid", "region", "kycStatus", "expiredAt" and "thirdPartyApp"

2025.10.24

[Margin Add] Get Margin Collateral Ratio

2025.10.17

Hedge Mode is currently supported in Futures Copy Trading.

[Futures Copy Trading Add] Switch Position Mode

[Futures Copy Trading Modify]

Endpoint	Request Param Change
Add Order	Added the positionSide parameter to enable Hedge Mode configuration.
Add Order Test	Added the positionSide parameter to enable Hedge Mode configuration.
Add Take Profit And Stop Loss Order	Added the positionSide parameter to enable Hedge Mode configuration.
Get Max Withdraw Margin	Added the positionSide parameter to enable Hedge Mode configuration.
Add Isolated Margin	Added the positionSide parameter to enable Hedge Mode configuration.
Remove Isolated Margin	Added the positionSide parameter to enable Hedge Mode configuration.
Modify Isolated Margin Auto-Deposit Status	Added the positionSide parameter to enable Hedge Mode configuration.

2025.09.30

Cross margin mode is available in Futures Copy Trading, with a maximum leverage of up to 20x.

[Futures Copy Trading Add]

Endpoint	Description
Switch Margin Mode	Modify the margin mode of the current symbol.
Modify Cross Margin Leverage	Modify the current symbol’s cross-margin leverage multiple.
Get Cross Margin Requirement	Querying the cross margin requirements of a symbol by position value.

[Futures Copy Trading Modify]

Endpoint	Request Param Change
Add Order	Max leverage is set to 20, and marginMode supports Cross.
Add Order Test	Max leverage is set to 20, and marginMode supports Cross.
Add Take Profit And Stop Loss Order	Max leverage is set to 20, and marginMode supports Cross.

2025.09.29

We are excited to announce the launch of public interfaces for the Unified Trading Account API on September 29, 2025, at 08:00 UTC. These interfaces provide a streamlined way to access trading and market data under the Unified Trading Account framework. The specific changes are as follows:
Domain Unification: All API requests for the Unified Trading Account will use the unified domain: https://api.kucoin.com.

Get Announcements

Description: Obtain the latest news announcements, with default page search for announcements within a month.

Replaces: GET /api/v3/announcements

Get Currency

Description: Request the currency details of a specified currency.

Replaces:

GET /api/v3/currencies/{currency}

GET /api/v3/currencies

Get Symbol

Description: Request a list of available currency pairs for trading.

Replaces:

SPOT: GET /api/v2/symbols/{symbol}

SPOT: GET /api/v2/symbols

FUTURES: GET /api/v1/contracts/{symbol}

FUTURES: GET /api/v1/contracts/active

Get Ticker

Description: Request market tickers for all the trading pairs in the market (including 24h volume); takes a snapshot every 2 seconds.

Replaces:

SPOT: GET /api/v1/market/orderbook/level1

SPOT: GET /api/v1/market/allTickers

FUTURES: GET /api/v1/ticker

FUTURES: GET /api/v1/allTickers

Get Trades

Description: Get the latest 100 trades of the specified symbol.

Replaces:

SPOT: GET /api/v1/market/histories

FUTURES: GET /api/v1/trade/history

Get OrderBook

Description: Query order book depth data (aggregated by price). Suitable for professional traders; use WebSocket incremental feed for updates due to strict rate limits.

Replaces:

SPOT: GET /api/v1/market/orderbook/level2_{size}

SPOT: GET /api/v3/market/orderbook/level2

FUTURES: GET /api/v1/level2/depth{size}

FUTURES: GET /api/v1/level2/snapshot

Get Klines

Description: Get the Kline (candlestick) data of the symbol, returned in grouped buckets based on requested type. Returns up to 1500 pieces of data per query; page by time for more data.

Replaces:

SPOT: GET /api/v1/market/candles

FUTURES: GET /api/v1/kline/query

Get Current Funding Rate

Description: Get the current futures funding fee rate.

Replaces: GET /api/v1/funding-rate/{symbol}/current

Get History Funding Rate

Description: Query the funding rate at each settlement time point within a certain time range for the corresponding contract.

Replaces: GET /api/v1/contract/funding-rates

10.

Get Cross Margin Config

Description: Request the configuration info of cross-margin trading.

Replaces: GET /api/v1/margin/config

11.

Get Service Status

Description: Get the service status.

Replaces:

SPOT: GET /api/v1/status

FUTURES: GET /api/v1/status

We will continue to roll out additional Unified Trading Account API interfaces in Q4 2025. Please refer to future announcements for updates.

2025.09.26

[Futures Add] Get Position Mode

[Broker Deprecate] Get API Broker Rebate, Deprecated the GET /api/v1/broker/api/rebase/download endpoint. Please use GET /api/v2/broker/api/rebase/download endpoint instead.

[Broker Add] Get Commission

[Broker Add] Get User List

[Broker Add] Get User Transactions

2025.09.25

[Futures Modify] Get Position Details endpoint: Upgrade from V1 to V2, /api/v2/position.

Endpoint	API Permission Changed
Get Recent Trade History	From Futures To General
Get Margin Mode	From Futures To General
Get Max Open Size	From Futures To General
Get Position Details	From Futures To General
Get Position List	From Futures To General
Get Positions History	From Futures To General
Get Max Withdraw Margin	From Futures To General
Get Cross Margin Leverage	From Futures To General
Get Cross Margin Risk Limit	From Futures To General
Get Private Funding History	From Futures To General

2025.09.12

[Futures Modify] Get Klines endpoint: Add transaction volume response parameter.

[Margin Add] Get Closed Orders
Above endpoints added cancelReason response parameter.

2025.08.12

[Margin Add] Get Borrow Rate

2025.08.11

[Affiliate Add] Get Transaction

2025.07.30

[Add] JAVA SDK

2025.07.24

[Add] Websocket Add Order, Websocket Cancel Order
added several new command options of this two endpoint

futures.multi_cancel

futures.multi_order

spot.sync_order

spot.modify

spot.sync_cancel

2025.07.22

[Futures Add]Get Cross Margin Requirement

2025.07.21

[Earn Add] Structured Product Purchase

[Earn Add] Get Dual Investment Products

[Earn Add] Get Structured Product Orders

2025.07.18

[Affiliate Add] Get Invited

[Affiliate Add]Get Commission

[Affiliate Add]Get Trade History

[Affiliate Deprecate]Get Account

2025.07.04

[Convert Add] Get Convert Symbol

[Convert Add] Get Convert Currencies

[Convert Add] Get Convert Quote

[Convert Add] Add Convert Order

[Convert Add] Get Convert Order Detail

[Convert Add] Get Convert Order History

[Convert Add] Get Convert Limit Quote

[Convert Add] Add Convert Limit Order

[Convert Add] Cancel Convert Limit Order

[Convert Add] Get Convert Limit Order Detail

[Convert Add] Get Convert Limit Orders

2025.07.01

[Add] API documentation support online debugging function (including private endpoint)

2025.06.30

[Add] Websocket Add Order

[Add] Websocket Cancel Order

2025.06.27

[Add] PHP SDK

2025.06.25

[Futures Modify] Websocket Push Orders endpoint, Add adl and liquid options to the request parameter tradeType

2025.06.12

[Futures Modify] Add Order, Add Order Test, Batch Add Orders, Add Take Profit And Stop Loss Order endpoint: leverage request parameter, changed from required to optional

2025.05.29

[Futures Modify] Get Current Funding Rate endpoint: add period, fundingTime response parameter.

2025.05.28

[Margin Modify] Get Account - Cross Margin endpoint: Added liabilityPrincipal, liabilityInterest response parameter.

2025.05.19

[Margin Modify] Add Order the rate limit quota has been adjusted from 5 to 2.
[Margin Modify] Add Order Test the rate limit quota has been adjusted from 5 to 2.
[Margin Modify] Cancel Order By OrderId the rate limit quota has been adjusted from 5 to 2.
[Margin Modify]Cancel Order By ClientOid the rate limit quota has been adjusted from 5 to 2.
[Margin Modify] Cancel All Orders By Symbol the rate limit quota has been adjusted from 10 to 5.
[Margin Modify] Get Symbols With Open Order the rate limit quota has been adjusted from 10 to 2.

2025.05.15

[Futures Add] Get Cross Margin Risk Limit, GET /api/v2/batchGetCrossOrderLimit

[Margin Modify] Get Account - Isolated Margin endpoint: Added liabilityPrincipal, liabilityInterest response parameter.

2025.05.14

[Futures Add] Batch Switch Margin Mode, POST /api/v2/position/batchChangeMarginMode

2025.05.13

[Spot Modify] Modify Order, POST /api/v1/hf/orders/alter the rate limit quota has been adjusted from 3 to 1.

2025.05.10

[Spot Add] Get Withdrawal History By ID, GET /api/v1/withdrawals/{withdrawalId}

2025.03.28

[Futures Modify] Get Position List, Get Position Details, Topic: /contract/positionAll, Topic:/contract/position:{symbol} endpoint: Cross margin support maintMarginReq, posMaint response parameter.

2025.03.13

[Spot Deprecate] Get Open Orders: Deprecated the GET /api/v1/hf/orders/active endpoint. Please use the new GET /api/v1/hf/orders/active/page endpoint instead.

2025.03.05

[Futures Modify] GET /api/v1/account-overview endpoint: Added maxWithdrawAmount response parameter.

[Futures Modify] Topic /contractAccount/wallet endpoint: Added maxWithdrawAmount response parameter.

[Spot Modify] GET /api/v1/sub-accounts/{subUserId} endpoint: Added baseCurrency, baseAmount request parameter.

2025.02.28

[Spot Modify] Add Order, Add Order Sync, Add Order Test, Batch Add Orders, Batch Add Orders Sync endpoint: Added allowMaxTimeWindow, clientTimestamp request parameter.

2025.02.27

[Add] API documentation now includes a Debug Function.

2025.02.26

[Add] Nodejs SDK

[Spot Add] Get Call Auction Part OrderBook, GET /api/v1/market/orderbook/callauction/level2_{size}

[Spot Add] Get Call Auction Info, GET /api/v1/market/callauctionData

[Spot Add] Call Auction Orderbook - Level50, Topic:/callauction/level2Depth50:{symbol}

[Spot Add] Call Auction Data, Topic: /callauction/callauctionData:{symbol}

[Spot Modify] GET /api/v2/symbols/{symbol} endpoint: Added callauctionIsEnabled, callauctionPriceFloor, callauctionPriceCeiling, callauctionFirstStageStartTime, callauctionSecondStageStartTime, callauctionThirdStageStartTime, tradingStartTime response parameter.

[Spot Modify] GET /api/v2/symbols endpoint: Added callauctionIsEnabled, callauctionPriceFloor, callauctionPriceCeiling, callauctionFirstStageStartTime, callauctionSecondStageStartTime, callauctionThirdStageStartTime, tradingStartTime response parameter.

2025.02.21

[Spot Add] Get Discount Rate Configs, GET /api/v1/otc-loan/discount-rate-configs

2025.02.19

[Modify] Rate Limit: The limit on the number of WebSocket connections that can be established simultaneously per user ID has been increased from 500 to 800.

2025.02.06

[Margin Modify] Get Transfer Quotas，GET /api/v1/accounts/transferable endpoint, Add MARGIN_V2 and ISOLATED_V2 options to the request parameter type

[Spot Modify] Get Account Ledgers - Trade_hf，GET /api/v1/hf/accounts/ledgers endpoint, Add RETURNED_FEES and DEDUCTION_FEES options to the request parameter bizType

2025.01.21

[Spot Add] Get Client IP Address, GET /api/v1/my-ip

2024.01.07

[Add] Futures Copy Trading has been launched, with 11 new endpoints.

[Futures Modify] Cancel All Orders: DELETE /api/v3/orders the rate limit quota has been adjusted from 30 to 10.

2024.01.03

[Add] Postman SDK

[Add] API documentation now includes a Search Function.

2024.12.17

[Modify] Rate Limit: The limit on the number of WebSocket connections that can be established simultaneously per user ID has been increased from 150 to 500.

[Futures Deprecate] Cancel All Orders: Deprecated the DELETE /api/v1/orders endpoint and adjusted the rate limit quota from 30 to 200. Please use the new DELETE /api/v3/orders endpoint instead.

[Futures Modify] Topic: /contractMarket/tradeOrders endpoint: Added the tradeType response parameter.

2024.12.01

[Add] The new version of the API documentation is now online.

2026.01.27#

2026.01.17#

2026.01.16#

2026.01.12#

2025.01.02#

2025.12.31#

2025.12.30#

2025.12.26#

2025.12.15#

2025.12.10#

2025.11.24#

2025.11.21#

2025.11.17#

2025.11.14#

2025.10.24#

2025.10.17#

2025.09.30#

2025.09.29#

2025.09.26#

2025.09.25#

2025.09.12#

2025.09.11#

2025.09.03#

2025.08.19#

2025.08.12#

2025.08.11#

2025.07.30#

2025.07.24#

2025.07.22#

2025.07.21#

2025.07.18#

2025.07.04#

2025.07.01#

2025.06.30#

2025.06.27#

2025.06.25#

2025.06.12#

2025.05.29#

2025.05.28#

2025.05.19#

2025.05.15#

2025.05.14#

2025.05.13#

2025.05.10#

2025.03.28#

2025.03.13#

2025.03.05#

2025.02.28#

2025.02.27#

2025.02.26#

2025.02.21#

2025.02.19#

2025.02.06#

2025.01.21#

2024.01.07#

2024.01.03#

2024.12.17#

2024.12.01#

2026.01.27

2026.01.17

2026.01.16

2026.01.12

2025.01.02

2025.12.31

2025.12.30

2025.12.26

2025.12.15

2025.12.10

2025.11.24

2025.11.21

2025.11.17

2025.11.14

2025.10.24

2025.10.17

2025.09.30

2025.09.29

2025.09.26

2025.09.25

2025.09.12

2025.09.11

2025.09.03

2025.08.19

2025.08.12

2025.08.11

2025.07.30

2025.07.24

2025.07.22

2025.07.21

2025.07.18

2025.07.04

2025.07.01

2025.06.30

2025.06.27

2025.06.25

2025.06.12

2025.05.29

2025.05.28

2025.05.19

2025.05.15

2025.05.14

2025.05.13

2025.05.10

2025.03.28

2025.03.13

2025.03.05

2025.02.28

2025.02.27

2025.02.26

2025.02.21

2025.02.19

2025.02.06

2025.01.21

2024.01.07

2024.01.03

2024.12.17

2024.12.01