術語定義

委託生命週期

發送至撮合引擎的有效訂單會立即確認，並處於received 狀態。
如果一個訂單立即對另一個訂單執行，則該訂單被視為done 。
訂單可以部分或全部執行。任何未立即成交的訂單部分將被視為open 。
訂單將維持在開放狀態，直到被取消或隨後被新訂單填補。不再符合配對條件（已完成或取消）的訂單會處於done 狀態。

手續費

在 KuCoin 平台上，訂單分為兩種類型：吃單（Taker）和掛單（Maker）。

吃單（Taker）：指直接與買賣盤中現有訂單配對成交的訂單。吃單會降低市場流動性，因此需支付較高的吃單手續費。

掛單（Maker）：指進入買賣盤並等待配對的訂單。掛單增加市場流動性，因此僅收取較低的掛單手續費，甚至可能獲得獎勵。

請注意：市價單、冰山單和隱藏委託都會收取吃單手續費係數。

訂單處理與費用扣除

資金預扣：

當您提交訂單時，系統會從您的帳戶中預扣部分資金，以支付可能的吃單手續費。
訂單的流動性屬性（由參數決定）決定其最終收取吃單手續費或掛單手續費。

限價單處理：

提交限價單後，系統會立即在撮合引擎中嘗試配對。若訂單立即與買賣盤中的現有訂單配對，則按吃單手續費計費。

若訂單未能立即配對或僅部分配對，剩餘部分將進入買賣盤，成為掛單。
對於進入買賣盤後成交或取消的訂單，將按掛單手續費計費。

撮合階段：

訂單進入撮合階段後，與交易對手的訂單進行配對。

當訂單剩餘金額為 0 時，交易完成。

若剩餘資金不足以滿足最低交易金額（0.00000001），訂單將被取消。

費用退還：

若您的訂單最終以掛單身份成交，系統將退還預扣的吃單手續費差額。

請注意：

隱藏單與冰山單：

當您建立隱藏/冰山單時，即使隱藏單或冰山單未被撮合引擎立即配對，且以掛單形式進入買賣盤，仍會按吃單手續費計費。

僅發佈訂單（Post-Only）

僅發佈的訂單將收取掛單費用。

如果下單後立即與市場上的現有訂單（冰山/隱藏委託除外）配對，則訂單將被取消。

如果僅發佈的訂單立即被冰山/隱藏委託填滿，則會對僅發佈訂單收取掛單費用。

例如：

以 BTC/USDT 為例，如果您要 1BTC 的市價，手續費為 0.1%，市價訂單資料如下：

Price(USDT)	Size(BTC)	Side
4200.00	0.18412309	賣
4015.60	0.56849308	賣
4011.32	0.24738383	賣
3995.64	0.84738383	買
3988.60	0.20484000	買
3983.85	1.37584908	買

當您下買入市場訂單時，該訂單會立即成交，交易明細會顯示 3 個交易，如下圖所示：

價格(USDT)	大小(BTC)	費用(BTC)
4011.32	0.24738383	0.00024738
4015.60	0.56849308	0.00056849
4200.00	0.18312409	0.00018312

零凍結取消訂單

零凍結取消訂單是一種特殊的訂單取消類型，發生在特定情況下，以下為其原因及詳細說明：

情境範例
假設當前帳戶持有多頭倉位 10 單位，且無額外可用資金，也無待平倉的空頭訂單。以下為可能的情況：

增加 5 張空頭訂單：

此訂單為平倉訂單，無需額外凍結保證金。

增加 10 張空頭訂單（完全平倉）：

此訂單完全抵銷多頭倉位，無需凍結保證金。

增加 11 張空頭訂單（平倉並反向開倉）：

此訂單不僅平倉多頭倉位，還開啟反向空頭倉位，系統會檢測到此訂單並可能因保證金不足觸發取消。

若帳戶持有多頭倉位 10 單位，無額外資金，且存在一筆待平倉的空頭訂單，該空頭訂單將被視為「平倉」（即佔用 0 凍結保證金）。若試圖平倉所有倉位，而系統檢測到部分訂單涉及「非零凍結」，則訂單可能被取消。此問題的根本原因通常來自先前存在的待平倉訂單。

解決方法
為避免零凍結取消訂單，建議在下單前檢查倉位狀態，具體如下：

倉位已平倉且無反向待平倉訂單：

無需特別處理，通常不會遇到問題。

反向開倉：

確保帳戶有足夠的保證金以支持反向開倉訂單。

平倉且存在反向待平倉訂單：

確保反向待平倉訂單的數量 ≤ 可用資金 - 已強平倉位。

帳戶有足夠資金（不考慮資金使用情況）：

下單時將參數 forceHold 設為 true，可避免零凍結取消問題。

未來優化
KuCoin 將優化合約系統邏輯，使反向開倉的凍結保證金計算更合理，提升交易體驗。。
https://www.kucoin.com/support/4415374025497

分頁

分頁允許透過指定當前頁數來獲取結果，非常適合即時數據。像 /api/v1/deposit-list、/api/v1/orders、/api/v1/fills 這樣的端點預設返回最新項目。如需獲取更多結果，使用者應在後續請求中指定 currentPage 編號，以根據先前返回的數據進行翻頁。

例子：

GET /api/v1/orders?currentPage=1&pageSize=50

{
  "currentPage": 1,
  "pageSize": 50,
  "totalNum": 6,
  "totalPage": 1,
  "data": ...
}

參數	預設值	描述
currentPage	1	當前請求頁數。
pageSize	50	每個請求的結果數量。最小值為 10，最大值為 500。

委託生命週期#

手續費#

零凍結取消訂單#

分頁#

委託生命週期

手續費

零凍結取消訂單

分頁