跳到主要内容

杠杆账户下单 (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;默认为 NO_SIDE_EFFECT. 详见FAQ
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"
}