新增訂單

說明

下單至幣幣交易系統，您可以下兩種主要的訂單：限價單和市價單。只有在您的帳戶有足夠資金的情況下才能下單。一旦下單，您的資金將在訂單期間暫停使用。保留的資金金額取決於指定的訂單類型和參數。

提示

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

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

提示

每個帳戶的有效訂單數量上限為 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）識別相關訊息。

價格保護機制

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

對於幣幣交易的市價單或限價單，若可直接與當前買賣盤中的訂單撮合，系統會檢查交易深度對應價格與點差的偏差是否超過閾值（閾值可通過Symbol 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

Request

Request Code Samples

Responses