新增訂單測試- 舊

建議使用POST/api/v1/hf/orders/test 端點，而不是此端點

說明

委託測試端點，此端點的請求參數和回傳參數與委託端點完全相同，可用於驗證簽章是否正確等操作。下單後，訂單不會進入撮合系統，也無法查詢訂單。

提示

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

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

提示

每個帳戶的最大有效訂單數量為 2000，每個交易對的最大有效訂單數量為 200（包括止損單）。

公開下單請求參數

Param	Type	Mandatory	Description
clientOid	String	Yes	clientOid，由客戶端建立的唯一識別碼，使用 UUID，最大長度為 128 位元。
side	String	Yes	buy or sell
symbol	String	Yes	symbol，例如.g.ETH-BTC
type	String	No	limit ormarket (default islimit)
remark	String	No	remark、Length cannot exceed 50 characters (ASCII)
stp	String	No	自成交防範, CN, CO, CB or DC
tradeType	String	No	交易類型：TRADE（幣幣交易），MARGIN_TRADE （槓桿交易）。預設為TRADE 。請注意：為了提高系統性能，加快下單和處理速度，KuCoin 增加了新的保證金下單界面。仍在使用目前界面的交易者，請儘快移至新界面。目前的將在 2021 年 5 月 1 日 (UTC) 前不再接受槓桿委託。屆時，KuCoin 會透過公告通知用戶，敬請留意。

限價單所需的額外請求參數

Param	Type	Mandatory	Description
price	String	Yes	Specify price for currency
size	String	Yes	Specify quantity for currency
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	冰山單中的最大可見數量

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

Param	Type	Mandatory	Description
size	String	No	(從兩者中選擇其一：`size` 或 `funds`)
funds	String	No	(二選一: `size` 或 `funds`)

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

新增訂單測試- 舊

限價單所需的額外請求參數#

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

Request

Request Code Samples

Responses

限價單所需的額外請求參數

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