订单频道
描述
订阅订单频道
以下事件发生时推送数据：
- 下开/平仓委托
- 开/平仓委托成交
- 撤单
请求示例
{
"op": "subscribe",
"args": [
{
"instType": "USDT-FUTURES",
"channel": "orders",
"instId": "default"
}
]
}
请求参数
| 参数名 | 参数类型 | 是否必须 | 描述 |
|---|---|---|---|
| op | String | 是 | 操作, subscribe unsubscribe |
| args | List<Object> | 是 | 请求订阅的频道列表 |
| > channel | String | 是 | 频道名 |
| > instType | String | 是 | 产品类型USDT-FUTURES USDT专业合约COIN-FUTURES 混合合约USDC-FUTURES USDC专业合约SUSDT-FUTURES USDT专业合约模拟盘SCOIN-FUTURES 混合合约模拟盘SUSDC-FUTURES USDC专业合约模拟盘 |
| > instId | String | 否 | 交易对，如BTCUSDTdefalut代表订阅所有交易对交割合约只支持 default |
订阅返回示例
{
"event": "subscribe",
"arg": {
"instType": "USDT-FUTURES",
"channel": "orders",
"instId": "default"
}
}
返回参数
| 返回字段 | 参数类型 | 字段说明 |
|---|---|---|
| event | String | 事件 |
| arg | Object | 订阅的频道 |
| > channel | String | 频道名 |
| > instType | String | 产品类型USDT-FUTURES USDT专业合约COIN-FUTURES 混合合约USDC-FUTURES USDC专业合约SUSDT-FUTURES USDT专业合约模拟盘SCOIN-FUTURES 混合合约模拟盘SUSDC-FUTURES USDC专业合约模拟盘 |
| > instId | String | 产品id |
| code | String | 错误码 |
| msg | String | 错误消息 |
推送返回示例
{
"action": "snapshot",
"arg": {
"instType": "USDT-FUTURES",
"channel": "orders",
"instId": "default"
},
"data": [
{
"accBaseVolume": "0.01",
"cTime": "1695718781129",
"clientOId": "1",
"feeDetail": [
{
"feeCoin": "USDT",
"fee": "-0.162003"
}
],
"fillFee": "-0.162003",
"fillFeeCoin": "USDT",
"fillNotionalUsd": "270.005",
"fillPrice": "27000.5",
"baseVolume": "0.01",
"stpMode":"cancel_taker",
"fillTime": "1695718781146",
"force": "gtc",
"instId": "BTCUSDT",
"leverage": "20",
"marginCoin": "USDT",
"marginMode": "crossed",
"notionalUsd": "270",
"orderId": "1",
"orderType": "market",
"pnl": "0",
"posMode": "hedge_mode",
"posSide": "long",
"price": "0",
"priceAvg": "27000.5",
"reduceOnly": "no",
"side": "buy",
"size": "0.01",
"enterPointSource": "WEB",
"status": "filled",
"tradeScope": "T",
"tradeId": "1111111111",
"tradeSide": "open",
"uTime": "1695718781146"
}
],
"ts": 1695718781206
}
推送数据参数
| 返回字段 | 参数类型 | 字段说明 |
|---|---|---|
| action | String | 推送动作, snapshot or update |
| arg | Object | 订阅成功的频道 |
| > channel | String | 频道名 |
| > instType | String | 产品类型USDT-FUTURES USDT专业合约COIN-FUTURES 混合合约USDC-FUTURES USDC专业合约SUSDT-FUTURES USDT专业合约模拟盘SCOIN-FUTURES 混合合约模拟盘SUSDC-FUTURES USDC专业合约模拟盘 |
| > instId | String | 产品ID |
| data | List<Object> | 订阅的数据 |
| > orderId | String | 订单ID |
| > clientOId | String | 自定义订单id |
| > price | String | 委托价格 |
| > size | String | 原始委托数量，以币为单位 |
| > posMode | String | 持仓模式one_way_mode：单向持仓hedge-mode: 双向持仓 |
| > enterPointSource | String | 订单来源 WEB WEB客户端 IOS IOS客户端 ANDROID Andriod客户端 API API客户端 SYS 系统, 通常为爆仓 |
| > tradeSide | String | 交易方向 |
| > notionalUsd | String | 委托单预估美元价值 |
| > orderType | String | 订单类型 limit 限价单， market 市价单 |
| > force | String | 订单有效期 |
| > side | String | 订单方向 |
| > posSide | String | 持仓方向long: 双向持仓多头short: 双向持仓空头net: 单向持仓 |
| > marginMode | String | 交易模式保证金模式crossed: 全仓isolated: 逐仓 |
| > marginCoin | String | 保证金币种 |
| > fillPrice | String | 最新成交价格 |
| > tradeId | String | 最新成交ID |
| > baseVolume | String | 最新成交数量 |
| > fillTime | String | 最新成交时间, Unix毫秒时间戳，例如1690196141868 |
| > fillFee | String | 最新一笔成交的手续费, 负数 |
| > fillFeeCoin | String | 最新一笔成交的手续费币种 |
| > tradeScope | String | 最新一笔成交的流动性方向 T：taker M：maker |
| > accBaseVolume | String | 累计成交数量 |
| > fillNotionalUsd | String | 委托单已成交的美元价值 |
| > priceAvg | String | 成交均价，如果成交数量为0，该字段为0；若未成交，该字段也为0 |
| > status | String | 订单状态 live 新建订单，orderbook中等待撮合 partially_filled 部分成交 filled 全部成交 canceled 已撤销 |
| > leverage | String | 杠杆倍数 |
| > feeDetail | List<Object> | 订单手续费 |
| >> feeCoin | String | 交易手续费币种 收取的就是保证金 |
| >> fee | String | 订单交易手续费，平台向用户收取的交易手续费 |
| > pnl | String | 收益 |
| > uTime | String | 订单更新时间，Unix时间戳的毫秒数格式，如 1597026383085 |
| > cTime | String | 订单创建时间，Unix时间戳的毫秒数格式，如 1597026383085 |
| > reduceOnly | String | 是否只减仓yes: 是no: 否 |
| > presetStopSurplusPrice | String | 预设止盈价格 |
| > presetStopLossPrice | String | 预设止损价格 |
| > stpMode | String | STP模式 none 不设置STP cancel_taker 取消taker单 cancel_maker 取消maker单 cancel_both 两者都取消 |