新增訂單測試 - KUCOIN API

說明

此端點的請求參數和回傳參數與訂單端點完全相同，可用於驗證簽名是否正確及其他操作。下單後，訂單不會進入撮合系統，且無法查詢該訂單。

提示

請注意，一旦您的訂單進入買賣盤，系統會提前凍結訂單的手續費。

在下單前，請務必充分瞭解各交易對參數的含義。

提示

每個帳戶的有效訂單數量上限為 2000，每個交易對的有效訂單數量上限為 200。

公開下單請求參數

參數	類型	是否必須	描述
clientOid	String	No	客戶訂單 ID，用戶建立的唯一識別碼、建議使用 UUID
symbol	String	Yes	交易對
type	String	Yes	訂單類型 `limit` 和 `market`
side	String	Yes	`buy` or `sell`
stp	String	No	自成交防範分為四種策略：`CN`, `CO`, `CB` , 和 `DC`
tags	String	No	訂單標籤，長度不能超過 `20` 個字符（ASCII）
remark	String	No	訂單備註、長度不可超過 `20` 個字元 (ASCII)

limit 限價單所需的附加請求參數

參數	類型	是否必須	描述
price	String	Yes	指定貨幣價格
size	String	Yes	指定貨幣數量
timeInForce	String	No	訂單時間策略 `GTC`、GTT`,` IOC`、`FOK`(預設為`GTC`)
cancelAfter	long	No	`n` 秒後取消，訂單定時策略為 `GTT`
postOnly	boolean	No	被動訂單標籤、當訂單計時策略為 `IOC` 或 `FOK` 時，此功能會停用
hidden	boolean	No	是否隱藏 (不顯示在買賣盤中)
iceberg	boolean	No	是否只在買賣盤中顯示訂單的可見部分？冰山單
visibleSize	String	No	冰山單中的最大可見數量

Market市價訂單所需的附加請求參數

參數	類型	是否必須	描述
size	String	No	(從兩者中選擇其一：`size` 或 `funds`)
funds	String	No	(二選一: `size` 或 `funds`)

Hold

對於限價購買訂單，我們將持有您的購買訂單所需的資金額（價格* 大小）。同樣地，對於限價賣出指令，我們也會持有您的賣出指令資產。交易執行時，會計算服務費。如果您取消已成交或未成交訂單的一部分，那麼剩餘的資金或金額將被釋放並退回到您的帳戶。對於需要特定資金的市價買/賣訂單，我們會從您的帳戶中保留所需資金。如果只指定了大小，我們可能會在訂單成交或取消之前凍結（通常是很短的時間）您帳戶中的所有資金。

委託生命週期

當下單請求成功（撮合引擎收到訂單）或拒絕（因資金不足或參數值不合法等原因）時，系統會回應 HTTP 請求。訂單成功下達時，會傳回訂單 ID。訂單將進行撮合，這可能導致訂單全部或部分成交。當訂單全部或部分成交時，訂單的剩餘部分將處於有效狀態，等待撮合（這不包括 IOC 訂單）。全部或部分成交（已取消）的訂單將進入「已完成」狀態。

訂閱市場數據頻道的用戶可以使用訂單 ID (orderId) 和客戶 ID (clientOid) 來識別訊息。

價格保護機制

下單時會啟用價格保護機制。詳細規則如下：

如果用戶下達的幣幣交易市價單/限價單可以直接與當前買賣盤中的訂單進行撮合，系統將判斷交易深度對應的價格與差價之間的偏差是否超過閾值（閾值可使用交易對 API 端點獲取）；

如果超出，對於限價單，訂單會直接取消；

如果是市價盤，系統會部分執行該訂單。執行限額將是與閾值相對應的價格範圍內的訂單大小。餘下的訂單將不會完成。

例如：如果閾值為 10%，當用戶在 KCS/USDT 交易市場下了 10,000 USDT 的市價購買訂單時（目前賣出價為 1.20000），系統會判定在訂單完全成交後，最終價格為 1.40000。(1.40000-1.20000)/1.20000=16.7%>10%.閾值為 1.32000。用戶的市價買入訂單只會在最高 1.32000 的情況下成交。剩餘的訂單部分將不會與買賣盤中的訂單撮合。請注意：此功能可能無法完全精確地判斷深度。如果您的訂單沒有完全成交，可能是因為超過閾值的部分沒有成交。

Request

Body Params application/json

Example

//limit order
{
    "type": "limit",
    "symbol": "BTC-USDT",
    "side": "buy",
    "price": "50000",
    "size": "0.00001",
    "clientOid": "5c52e11203aa677f33e493fb",
    "remark": "order remarks"
}

//market order 1
// {
//     "type": "market",
//     "symbol": "BTC-USDT",
//     "side": "buy",
//     "size": "0.00001",
//     "clientOid": "5c52e11203aa677f33e493fc",
//     "remark": "order remarks"
// }

//market order 2
// {
//     "type": "market",
//     "symbol": "BTC-USDT",
//     "side": "buy",
//     "funds": "1",
//     "clientOid": "5c52e11203aa677f33e493fc",
//     "remark": "order remarks"
// }

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200確認

application/json

Body

Example

{
    "success": true,
    "code": "200000",
    "data": {
        "orderId": "5bd6e9286d99522a52e458de",
        "clientOid": "5c52e11203aa677f33e493fb",
        "borrowSize": 10.2,
        "loanApplyId": "600656d9a33ac90009de4f6f"
    }
}