訂單

槓桿下單

{
    "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 訂單類型 limitmarket(默認爲 limit)
remark String 訂單說明,長度不超過50個字符(編碼只支持ASCII)
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 被動委託的標識, 當訂單時效策略爲IOCFOK 時無效
hidden boolean 是否隱藏(買賣盤中不展示)
iceberg boolean 冰山單中是否僅顯示訂單的可見部分
visibleSize String 冰山單最大的展示數量
market 市價單額外所需請求參數
請求參數 類型 是否必須 含義
size String 否(sizefunds二選一) 下單數量
funds String 否(sizefunds二選一) 下單資金
  • 下市價單,需定買賣數量或資金。市價買單,funds參數必傳。
返回值
字段 含義
orderId 訂單Id
borrowSize 借幣數量,只有在自動借幣下單後才返回
loanApplyId 借幣申請ID,只有在自動借幣下單後才返回

下單成功後,會返回一個orderId字段,意味這訂單進入撮合引擎。

術語解釋
交易模式(marginModel)

交易模式有:全倉(cross)與逐倉(isolated),默認爲全倉模式。

自動借幣下單(autoBorrow)

自動借幣下單標識,如此字段爲true,則會根據下單量,自動借入下單所需的金額。默認爲false。如果下單量過大,超過了最大槓桿倍數或者風險限額閾值,則借幣失敗,下單也會失敗。目前只支持全倉(cross)借幣下單

可能會存在借款成功,但是下單失敗的情況,此時可以直接不帶auto-borrow參數再次下單即可,或者選擇還款操作