条件单下单 (TRADE)
接口描述
条件单下单
方式
algoOrder.place
请求
{
"id": "7731f6b5-8d5e-419c-a424-016b0a5fe8d7",
"method": "algoOrder.place",
"params": {
"algoType": "CONDITIONAL",
"apiKey": "autoApiKey7mM4kPWaRuTUypdTEZKG8U8tDjO64xdBJBrmE1nXU2XSwdxGPyXcYx",
"newOrderRespType": "RESULT",
"positionSide": "SHORT",
"price": "160000",
"quantity": "1",
"recvWindow": "99999999",
"side": "SELL",
"symbol": "BTCUSDT",
"timeInForce": "GTC",
"timestamp": 1762506268690,
"triggerPrice": 120000,
"type": "TAKE_PROFIT",
"signature": "ec6e529c69fd8193b19484907bc713114eae06259fcab9728dafd5910f9cac5a"
}
}
请求权重
0
请求参数
| 名称 | 类型 | 是否必需 | 描述 |
|---|---|---|---|
| algoType | ENUM | YES | 仅支持 CONDITIONAL |
| symbol | STRING | YES | 交易对 |
| side | ENUM | YES | 买卖方向 SELL, BUY |
| positionSide | ENUM | NO | 持仓方向，单向持仓模式下非必填，默认且仅可填BOTH;在双向持仓模式下必填,且仅可选择 LONG 或 SHORT |
| type | ENUM | YES | 条件订单类型 STOP, TAKE_PROFIT, STOP_MARKET, TAKE_PROFIT_MARKET, TRAILING_STOP_MARKET |
| timeInForce | ENUM | NO | IOC or GTC or FOK, 默认 GTC |
| quantity | DECIMAL | NO | 下单数量,使用closePosition不支持此参数。 |
| price | DECIMAL | NO | 委托价格 |
| triggerPrice | DECIMAL | NO | 触发价 |
| workingType | ENUM | NO | 触发类型: MARK_PRICE(标记价格), CONTRACT_PRICE(合约最新价). 默认 CONTRACT_PRICE |
| priceMatch | ENUM | NO | OPPONENT/ OPPONENT_5/ OPPONENT_10/ OPPONENT_20/QUEUE/ QUEUE_5/ QUEUE_10/ QUEUE_20； 不能与price同时传 |
| closePosition | STRING | NO | true, false；触发后全部平仓，仅支持STOP_MARKET和TAKE_PROFIT_MARKET；不与quantity合用；自带只平仓效果，不与reduceOnly 合用 |
| priceProtect | STRING | NO | 条件单触发保护："true","false", 默认"false". |
| reduceOnly | STRING | NO | true, false; 非双开模式下默认false；双开模式下不接受此参数； 使用closePosition不支持此参数。 |
| activatePrice | DECIMAL | NO | 追踪止损激活价格，仅TRAILING_STOP_MARKET 需要此参数, 默认为下单当前市场价格(支持不同workingType) |
| callbackRate | DECIMAL | NO | 追踪止损回调比例，可取值范围[0.1, 10],其中 1代表1% ,仅TRAILING_STOP_MARKET 需要此参数 |
| clientAlgoId | STRING | NO | 用户自定义的条件订单号，不可以重复出现在挂单中。如空缺系统会自动赋值。必须满足正则规则 ^[\.A-Z\:/a-z0-9_-]{1,36}$ |
| newOrderRespType | ENUM | NO | "ACK", "RESULT", 默认 "ACK" |
| selfTradePreventionMode | ENUM | NO | EXPIRE_TAKER/ EXPIRE_MAKER/ EXPIRE_BOTH； 默认NONE |
| goodTillDate | LONG | NO | TIF为GTD时订单的自动取消时间， 当timeInforce为GTD时必传；传入的时间戳仅保留秒级精度，毫秒级部分会被自动忽略，时间戳需大于当前时间+600s且小于253402300799000 |
| recvWindow | LONG | NO | |
| timestamp | LONG | YES |
条件单的触发必须:
- 如果订单参数
priceProtect为true:
- 达到触发价时，
MARK_PRICE(标记价格)与CONTRACT_PRICE(合约最新价)之间的价差不能超过改symbol触发保护阈值- 触发保护阈值请参考接口
GET /fapi/v1/exchangeInfo返回内容相应symbol中"triggerProtect"字段STOP,STOP_MARKET止损单:
- 买入: 最新合约价格/标记价格高于等于触发价
stopPrice- 卖出: 最新合约价格/标记价格低于等于触发价
stopPriceTAKE_PROFIT,TAKE_PROFIT_MARKET止盈单:
- 买入: 最新合约价格/标记价格低于等于触发价
stopPrice- 卖出: 最新合约价格/标记价格高于等于触发价
stopPriceTRAILING_STOP_MARKET跟踪止损单:
- 买入: 当合约价格/标记价格区间最低价格低于激活价格
activatePrice,且最新合约价格/标记价高于等于最低价设定回调幅度。- 卖出: 当合约价格/标记价格区间最高价格高于激活价格
activatePrice,且最新合约价格/标记价低于等于最高价设定回调幅度。
TRAILING_STOP_MARKET跟踪止损单如果遇到报错{"code": -2021, "msg": "Order would immediately trigger."}
表示订单不满足以下条件:
- 买入: 指定的
activatePrice必须小于 latest price- 卖出: 指定的
activatePrice必须大于 latest price
STOP_MARKET,TAKE_PROFIT_MARKET配合closePosition=true:
- 条件单触发依照上述条件单触 发逻辑
- 条件触发后，平掉当时持有所有多头仓位(若为卖单)或当时持有所有空头仓位(若为买单)
- 不支持
quantity参数- 自带只平仓属性，不支持
reduceOnly参数- 双开模式下,
LONG方向上不支持BUY;SHORT方向上不支持SELL
selfTradePreventionMode仅在timeInForce为IOC或GTC或GTD时生效.
响应示例
{
"id": "06c9dbd8-ccbf-4ecf-a29c-fe31495ac73f",
"status": 200,
"result": {
"algoId": 3000000000003505,
"clientAlgoId": "0Xkl1p621E4EryvufmYre1",
"algoType": "CONDITIONAL",
"orderType": "TAKE_PROFIT",
"symbol": "BTCUSDT",
"side": "SELL",
"positionSide": "SHORT",
"timeInForce": "GTC",
"quantity": "1.000",
"algoStatus": "NEW",
"triggerPrice": "120000.00",
"price": "160000.00",
"icebergQuantity": null,
"selfTradePreventionMode": "EXPIRE_MAKER",
"workingType": "CONTRACT_PRICE",
"priceMatch": "NONE",
"closePosition": false,
"priceProtect": false,
"reduceOnly": false,
"createTime": 1762507264142,
"updateTime": 1762507264143,
"triggerTime": 0,
"goodTillDate": 0
},
"rateLimits": [
{
"rateLimitType": "REQUEST_WEIGHT",
"interval": "MINUTE",
"intervalNum": 1,
"limit": 2400,
"count": 1
}
]
}