跳到主要内容

查询已触发条件单

查询已触发条件单

查询已触发的条件单历史记录

限频:每秒 1 次

请求地址

GET /deepcoin/trade/trigger-orders-history

请求参数

字段名是否必填类型字段描述
instTypestring产品类型
币币: SPOT
合约: SWAP
instIdstring产品 ID,如 BTC-USDT-SWAP
OrderTypestring触发订单类型
限价单: limit
市价单: market
limitinteger分页返回的结果集数量,最大为 100,不填默认返回 100 条,取值范围:1-100
ordIdstring订单 ID

响应参数

字段名类型字段描述
instTypestring产品类型,如 SWAP
instIdstring产品 ID,如 BTC-USDT-SWAP
ordIdstring订单 ID
pxstring委托价格
szstring委托数量
triggerPxstring触发价格
triggerPxTypestring触发价格类型
最新价: last
指数价: index
标记价: mark
ordTypestring触发订单类型
TPSL: 止盈止损
Conditional: 条件单
Serial: 连续下单
Indicator: 指标单
Complex: 组合指标
Tracking: 追踪出场
Line: 画线委托
sidestring订单方向
买: buy
卖: sell
posSidestring持仓方向
开平仓模式开多: long
开平仓模式开空: short
买卖模式: net
tdModestring交易模式
全仓: cross
逐仓: isolated
非保证金: cash
leverstring杠杆倍数
triggerTimestring触发时间,Unix 时间戳的毫秒数格式,如 1597026383085
值为 0 表示未触发
uTimestring订单状态更新时间,Unix 时间戳的毫秒数格式
cTimestring订单创建时间,Unix 时间戳的毫秒数格式
errorCodestring错误码
0: 成功
4: 无效操作
errorMsgstring错误信息,如 InvalidAction:OrderType=5,CFDPriceIsNull

响应示例

{
"code": "0",
"msg": "",
"data": [
{
"instType": "SWAP",
"instId": "BTC-USDT-SWAP",
"ordId": "1000595886219036",
"px": "140000",
"sz": "100",
"triggerPx": "150000",
"triggerPxType": "last",
"ordType": "Conditional",
"side": "buy",
"posSide": "long",
"tdMode": "cross",
"lever": "11",
"triggerTime": "0",
"uTime": "1758026276000",
"cTime": "1757918143",
"errorCode": "0",
"errorMsg": ""
},
{
"instType": "SWAP",
"instId": "BTC-USDT-SWAP",
"ordId": "1000595882098321",
"px": "0",
"sz": "200",
"triggerPx": "0",
"triggerPxType": "last",
"ordType": "TPSL",
"side": "sell",
"posSide": "long",
"tdMode": "cross",
"lever": "11",
"triggerTime": "0",
"uTime": "1758026278000",
"cTime": "1757660515",
"errorCode": "0",
"errorMsg": ""
},
{
"instType": "SWAP",
"instId": "BTC-USDT-SWAP",
"ordId": "1000594091040387",
"px": "0",
"sz": "0",
"triggerPx": "80000",
"triggerPxType": "last",
"ordType": "TPSL",
"side": "sell",
"posSide": "long",
"tdMode": "cross",
"lever": "1",
"triggerTime": "1751505074",
"uTime": "1751505074000",
"cTime": "1749695677",
"errorCode": "4",
"errorMsg": "InvalidAction:OrderType=5,CFDPriceIsNull"
}
]
}

注意事项

  1. 该接口返回已经触发的条件单历史记录,包括成功触发和触发失败的订单
  2. triggerTime0 表示订单尚未触发
  3. errorCode0 表示成功,其他值表示失败
  4. px0 表示市价单,非零值表示限价单
  5. 返回结果按更新时间倒序排列,最新的记录在前