Skip to main content

杠杆账户下单 (TRADE)

接口描述#

杠杆账户下单

HTTP请求#

POST /sapi/v1/margin/order

请求权重#

6(UID)

请求参数#

名称类型是否必需描述
symbolSTRINGYES
isIsolatedSTRINGNO是否逐仓杠杆,"TRUE", "FALSE", 默认 "FALSE"
sideENUMYESBUY
SELL
typeENUMYES详见枚举定义:订单类型
quantityDECIMALNO
quoteOrderQtyDECIMALNO
priceDECIMALNO
stopPriceDECIMALNOSTOP_LOSS, STOP_LOSS_LIMIT, TAKE_PROFIT, 和 TAKE_PROFIT_LIMIT 订单一起使用.
newClientOrderIdSTRINGNO客户自定义的唯一订单ID。若未发送自动生成。
icebergQtyDECIMALNOLIMIT, STOP_LOSS_LIMIT, 和 TAKE_PROFIT_LIMIT 一起使用创建 iceberg 订单.
newOrderRespTypeENUMNO设置响应: JSON. ACK, RESULT, 或 FULL; MARKET 和 LIMIT 订单类型默认为 FULL, 所有其他订单默认为 ACK.
sideEffectTypeENUMNONO_SIDE_EFFECT, MARGIN_BUY, AUTO_REPAY, AUTO_BORROW_REPAY,AUTO_BORROW_REPAY;默认为 NO_SIDE_EFFECT.
timeInForceENUMNOGTC,IOC,FOK
selfTradePreventionModeENUMNO允许的 ENUM 取决于交易对的配置。支持的值有 EXPIRE_TAKER,EXPIRE_MAKER,EXPIRE_BOTH,NONE
autoRepayAtCancelBOOLEANNO只有在自动借款单或者自动借还单生效,true表示的是撤单后需要把订单产生的借款归还,默认为true
recvWindowLONGNO赋值不能大于 60000
timestampLONGYES
  • autoRepayAtCancel 补充说明: 在频繁下单撤单的情况下,为提高资金利用率,建议设置为FALSE

响应示例#

Response ACK:

{  "symbol": "BTCUSDT",  "orderId": 28,  "clientOrderId": "6gCrw2kRUAF9CvJDGP16IP",  "isIsolated": true,       // 是否是逐仓symbol交易  "transactTime": 1507725176595}

Response RESULT:

{    "symbol": "BTCUSDT",    "orderId": 26769564559,    "clientOrderId": "E156O3KP4gOif65bjuUK5V",    "transactTime": 1713873075893,    "price": "0",    "origQty": "0.001",    "executedQty": "0.001",    "cummulativeQuoteQty": "65982.53",    "status": "FILLED",    "timeInForce": "GTC",    "type": "MARKET",    "side": "SELL",    "isIsolated": false,   // 是否是逐仓symbol交易    "selfTradePreventionMode": "EXPIRE_MAKER"}

Response FULL:

{    "symbol": "BTCUSDT",    "orderId": 26769564559,    "clientOrderId": "E156O3KP4gOif65bjuUK5V",    "transactTime": 1713873075893,    "price": "0",    "origQty": "0.001",    "executedQty": "0.001",    "cummulativeQuoteQty": "65.98253",    "status": "FILLED",    "timeInForce": "GTC",    "type": "MARKET",    "side": "SELL",    "marginBuyBorrowAmount": 5,       // 下单后没有发生借款则不返回该字段    "marginBuyBorrowAsset": "BTC",    // 下单后没有发生借款则不返回该字段    "fills": [        {            "price": "65982.53",            "qty": "0.001",            "commission": "0.06598253",            "commissionAsset": "USDT",            "tradeId": 3570680726        }    ],    "isIsolated": false,    "selfTradePreventionMode": "EXPIRE_MAKER"}