訂單
槓桿下單
{
"orderId":"5bd6e9286d99522a52e458de",
"borrowSize":10.2,
"loanApplyId":"600656d9a33ac90009de4f6f"
}
訂單有兩種類型:
限價單(limit
): 指定價格和數量進行交易。
市價單(market
) : 指定資金或數量進行交易。
在下單前,請確保您的槓桿賬戶有足夠的資金。一旦下單成功,您下單的金額會被凍結。凍結金額的多少取決於您下單的類型和具體的請求參數。
TIP
下單將啓用價格保護機制。當限價單的價格在閾值範圍之外時,會觸發價格保護機制,導致下單失敗。
請悉知,當您的訂單進入買賣盤,系統會提前凍結訂單的手續費。
在下單之前,請充分了解每一個交易對的參數含義。
請求體中的JSON字符串中不要有多餘的空格
下單限制
對於一個賬號,每一個交易對最大活躍委託訂單數量200
(包含止損單)。
HTTP請求
POST /api/v1/margin/order
API權限
此接口需要槓桿交易權限
請求URL
此接口支持現貨URL
頻率限制
現貨類權重
:5
請求參數
下單公有的請求參數
請求參數 | 類型 | 是否必須 | 含義 |
---|---|---|---|
clientOid | String | 是 | 客戶端創建的唯一標識,建議使用UUID |
side | String | 是 | buy (買) 或 sell (賣) |
symbol | String | 是 | 交易對 比如,ETH-BTC |
type | String | 否 | 訂單類型 limit 和market (默認爲 limit ) |
stp | String | 否 | 自成交保護 分爲CN , CO , CB , DC 四種策略 |
marginModel | String | 否 | 槓桿交易模式,分爲cross (全倉模式), isolated (逐倉模式), 默認爲cross 。 |
autoBorrow | boolean | 否 | 自動借幣下單,即系統自動以市場最優利率借幣再下單。 (目前只支持全倉不支持逐倉),借幣下單時,不支持止盈止損,如果是賣單,size必傳 |
autoRepay | boolean | 否 | 下單自動還幣,即訂單成交後系統自動觸發還幣,最大還幣金額為成交金額,同一訂單暫不支持自動借幣和自動還幣同時使用 |
limit 限價單額外所需請求參數
請求參數 | 類型 | 是否必須 | 含義 |
---|---|---|---|
price | String | 是 | 指定幣種的價格 |
size | String | 是 | 指定幣種的數量 |
timeInForce | String | 否 | 訂單時效策略:GTC , GTT , IOC , FOK (默認爲GTC ) |
cancelAfter | long | 否 | n 秒之後取消,訂單時效策略爲 GTT |
postOnly | boolean | 否 | 被動委託的標識, 當訂單時效策略爲IOC 或FOK 時無效 |
hidden | boolean | 否 | 是否隱藏(買賣盤中不展示) |
iceberg | boolean | 否 | 冰山單中是否僅顯示訂單的可見部分 |
visibleSize | String | 否 | 冰山單最大的展示數量 |
market 市價單額外所需請求參數
請求參數 | 類型 | 是否必須 | 含義 |
---|---|---|---|
size | String | 否(size 和funds 二選一) | 下單數量 |
funds | String | 否(size 和funds 二選一) | 下單資金 |
- 下市價單,需定買賣數量或資金。市價買單,funds參數必傳。
返回值
字段 | 含義 |
---|---|
orderId | 訂單Id |
borrowSize | 借幣數量,只有在自動借幣下單後才返回 |
loanApplyId | 借幣申請ID,只有在自動借幣下單後才返回 |
下單成功後,會返回一個orderId
字段,意味這訂單進入撮合引擎。
術語解釋
交易模式(marginModel)
交易模式有:全倉(cross
)與逐倉(isolated
),默認爲全倉模式。
自動借幣下單(autoBorrow)
自動借幣下單標識,如此字段爲true
,則會根據下單量,自動借入下單所需的金額。默認爲false
。如果下單量過大,超過了最大槓桿倍數或者風險限額閾值,則借幣失敗,下單也會失敗。目前只支持全倉(cross
)借幣下單
可能會存在借款成功,但是下單失敗的情況,此時可以直接不帶auto-borrow參數再次下單即可,或者選擇還款操作