Order Lifecycle#
Valid orders sent to the matching engine are confirmed immediately and are in the received state.
If an order executes against another order immediately, the order is considered done.
An order can execute in part or whole. Any part of the order not filled immediately will be considered open.
Orders will stay in the open state until canceled or subsequently filled by new orders. Orders that are no longer eligible for matching (filled or canceled) are in the done state.Handling Fees#
Orders on the KuCoin platform are divided into two types: Taker and Maker. Taker orders can be filled with existing orders in the order book. Conversely, Maker orders will stay in the order book and await matching. Taker orders decrease market liquidity and therefore charge a taker fee. Maker orders increase market liquidity and therefore only charge a lower handling fee or may even pay out rewards. Note: Market orders, iceberg orders, and hidden orders all charge taker fees.When an order is placed, the system puts a hold on a portion of the funds in your account to pay the taker fee. Parameter values in the liquidity field determine whether taker fees or maker fees will be charged for the order.If your order is a market order, when the order is placed it will immediately be matched in the matching engine and we will charge a taker fee. If your order is not immediately matched or is only partially matched, the remaining portions will enter the order book. Maker fees will be charged for orders that have entered the order book before they are canceled or filled.After entering the matching stage, matching will be conducted with counterparty orders. When the remaining amount for the order is 0, the transaction is complete. If the remaining funds are not enough to purchase the minimum amount (0.00000001), the order is canceled.If your order is filled as a maker, we will refund the remaining amount of withheld taker fees.When you create a hidden/iceberg order, even if it is not immediately matched by the matching engine and is filled as post only, a taker fee will still be charged.
Maker fees will be charged for post only orders. If the order is immediately matched with existing orders (with the exception of iceberg/hidden orders) on the market after order placement, then the order will be canceled. If a post only order is immediately filled with iceberg/hidden orders, a maker fee will be charged for the post only order.
| Price(USDT) | Size(BTC) | Side |
|---|
| 4200.00 | 0.18412309 | sell |
| 4015.60 | 0.56849308 | sell |
| 4011.32 | 0.24738383 | sell |
| 3995.64 | 0.84738383 | buy |
| 3988.60 | 0.20484000 | buy |
| 3983.85 | 1.37584908 | buy |
When you place a buy market order, it will be filled immediately, and the transaction detailed will show 3 transactions, as shown below:| Price(USDT) | Size(BTC) | Fee(BTC) |
|---|
| 4011.32 | 0.24738383 | 0.00024738 |
| 4015.60 | 0.56849308 | 0.00056849 |
| 4200.00 | 0.18312409 | 0.00018312 |
Zero Freeze Cancel Order#
A special type of order cancellation; the specific reasons are as follows, for example:If the current long position is 10, the account has no additional funds and no short pending orders.1.
Add 5 short orders, and no additional freezing of margin will be made.
2.
Add 10 short orders (close the position), and the margin will not be frozen.
3.
Add 11 short orders (close the position and open the position in the opposite direction), and the system will detect that order.
1.
If the position is closed and there is no reverse pending order. Disregard; in general, you should not encounter any problems.
2.
If it is a reversal to open a position: It is necessary to ensure that the account has sufficient margin to place an order.
3.
If it is to close the position, there is a reverse pending order. It is necessary to ensure that the number of reverse pending orders < = available funds - the number of liquidated positions.
4.
If the account has enough money (regardless of fund utilization): Set forceHold to true when placing an order, and the problem will not be encountered.
GET /api/v1/orders?currentPage=1&pageSize=50{
"currentPage": 1,
"pageSize": 50,
"totalNum": 6,
"totalPage": 1,
"data": ...
}
| Parameter | Default | Description |
|---|
| currentPage | 1 | Current request page. |
| pageSize | 50 | Number of results per request. Minimum is 10, maximum is 500. |
Modified at 2025-12-02 07:33:17
