下单(TRADE)

接口描述

下单(TRADE)

条件单的触发必须:
- 如果订单参数priceProtect为true:
  - 达到触发价时，MARK_PRICE(标记价格)与CONTRACT_PRICE(合约最新价)之间的价差不能超过改symbol触发保护阈值
  - 触发保护阈值请参考接口GET /dapi/v1/exchangeInfo 返回内容相应symbol中"triggerProtect"字段
- STOP, STOP_MARKET 止损单:
  - 买入: 最新合约价格/标记价格高于等于触发价stopPrice
  - 卖出: 最新合约价格/标记价格低于等于触发价stopPrice
- TAKE_PROFIT, TAKE_PROFIT_MARKET 止盈单:
  - 买入: 最新合约价格/标记价格低于等于触发价stopPrice
  - 卖出: 最新合约价格/标记价格高于等于触发价stopPrice
- TRAILING_STOP_MARKET 跟踪止损单:
  - 买入: 当合约价格/标记价格区间最低价格低于激活价格activationPrice,且最新合约价格/标记价高于等于最低价设定回调幅度。
  - 卖出: 当合约价格/标记价格区间最高价格高于激活价格activationPrice,且最新合约价格/标记价低于等于最高价设定回调幅度。
TRAILING_STOP_MARKET 跟踪止损单如果遇到报错 {"code": -2021, "msg": "Order would immediately trigger."}
表示订单不满足以下条件:
- 买入: 指定的activationPrice 必须小于 latest price
- 卖出: 指定的activationPrice 必须大于 latest price
newOrderRespType 如果传 RESULT:
- MARKET 订单将直接返回成交结果；
- 配合使用特殊 timeInForce 的 LIMIT 订单将直接返回成交或过期拒绝结果。
STOP_MARKET, TAKE_PROFIT_MARKET 配合 closePosition=true:
- 条件单触发依照上述条件单触发逻辑
- 条件触发后,平掉当时持有所有多头仓位(若为卖单)或当时持有所有空头仓位(若为买单)
- 不支持 quantity 参数
- 自带只平仓属性,不支持reduceOnly参数
- 双开模式下,LONG方向上不支持BUY; SHORT 方向上不支持SELL

HTTP请求

POST /dapi/v1/order

请求权重

10s order rate limit(X-MBX-ORDER-COUNT-10S)为1; 1min order rate limit(X-MBX-ORDER-COUNT-1M)为1; IP rate limit(x-mbx-used-weight-1m)为0

请求参数

名称	类型	是否必需	描述
symbol	STRING	YES	交易对
side	ENUM	YES	买卖方向 `SELL`, `BUY`
positionSide	ENUM	NO	持仓方向,单向持仓模式下非必填,默认且仅可填`BOTH`;在双向持仓模式下必填,且仅可选择 `LONG` 或 `SHORT`
type	ENUM	YES	订单类型 `LIMIT`, `MARKET`, `STOP`, `TAKE_PROFIT`, `STOP_MARKET`, `TAKE_PROFIT_MARKET`, `TRAILING_STOP_MARKET`
reduceOnly	STRING	NO	`true`, `false`; 非双开模式下默认`false`；双开模式下不接受此参数；使用`closePosition`不支持此参数。
quantity	DECIMAL	NO	以合约数量计量的下单数量，使用`closePosition`不支持此参数。
price	DECIMAL	NO	委托价格
newClientOrderId	STRING	NO	用户自定义的订单号,不可以重复出现在挂单中。如空缺系统会自动赋值。必须满足正则规则 `^[\.A-Z\:/a-z0-9_-]{1,36}$`
stopPrice	DECIMAL	NO	触发价, 仅 `STOP`, `STOP_MARKET`, `TAKE_PROFIT`, `TAKE_PROFIT_MARKET` 需要此参数
closePosition	STRING	NO	`true`, `false`；触发后全部平仓,仅支持`STOP_MARKET`和`TAKE_PROFIT_MARKET`；不与`quantity`合用；自带只平仓效果,不与`reduceOnly` 合用
activationPrice	DECIMAL	NO	追踪止损激活价格,仅`TRAILING_STOP_MARKET` 需要此参数, 默认为下单当前市场价格(支持不同`workingType`)
callbackRate	DECIMAL	NO	追踪止损回调比例,可取值范围[0.1, 4],其中 1代表1% ,仅`TRAILING_STOP_MARKET` 需要此参数
timeInForce	ENUM	NO	有效方法
workingType	ENUM	NO	stopPrice 触发类型: `MARK_PRICE`(标记价格), `CONTRACT_PRICE`(合约最新价). 默认 `CONTRACT_PRICE`
priceProtect	STRING	NO	条件单触发保护："TRUE","FALSE", 默认"FALSE". 仅 `STOP`, `STOP_MARKET`, `TAKE_PROFIT`, `TAKE_PROFIT_MARKET` 需要此参数
newOrderRespType	ENUM	NO	"ACK", "RESULT", 默认 "ACK"
recvWindow	LONG	NO
timestamp	LONG	YES

根据 order type的不同,某些参数强制要求,具体如下:

Type	强制要求的参数
`LIMIT`	`timeInForce`, `quantity`, `price`
`MARKET`	`quantity`
`STOP`, `TAKE_PROFIT`	`quantity`, `price`, `stopPrice`
`STOP_MARKET`, `TAKE_PROFIT_MARKET`	`stopPrice`
`TRAILING_STOP_MARKET`	`callbackRate`

响应示例

{
 	"clientOrderId": "testOrder", // 用户自定义的订单号
 	"cumQty": "0",
 	"cumBase": "0", // 成交额(标的数量)
 	"executedQty": "0", // 成交量(张数)
 	"orderId": 22542179, // 系统订单号
 	"avgPrice": "0.0",		// 平均成交价
 	"origQty": "10", // 原始委托数量
 	"price": "0", // 委托价格
 	"reduceOnly": false, // 仅减仓
 	"closePosition": false,   // 是否条件全平仓
 	"side": "SELL", // 买卖方向
 	"positionSide": "SHORT", // 持仓方向
 	"status": "NEW", // 订单状态
 	"stopPrice": "0", // 触发价,对`TRAILING_STOP_MARKET`无效
 	"symbol": "BTCUSD_200925", // 交易对
 	"pair": "BTCUSD",	// 标的交易对
 	"timeInForce": "GTC", // 有效方法
 	"type": "TRAILING_STOP_MARKET", // 订单类型
 	"origType": "TRAILING_STOP_MARKET",  // 触发前订单类型
 	"activatePrice": "9020", // 跟踪止损激活价格, 仅`TRAILING_STOP_MARKET` 订单返回此字段
  	"priceRate": "0.3",	// 跟踪止损回调比例, 仅`TRAILING_STOP_MARKET` 订单返回此字段
 	"updateTime": 1566818724722, // 更新时间
 	"workingType": "CONTRACT_PRICE", // 条件价格触发类型
 	"priceProtect": false            // 是否开启条件单触发保护
}

下单(TRADE)

接口描述​

HTTP请求​

请求权重​

请求参数​

响应示例​

接口描述

HTTP请求

请求权重

请求参数

响应示例