# 订单频道
### 描述
订阅订单频道
以下事件发生时推送数据：
1. 下开/平仓委托
2. 开/平仓委托成交
3. 撤单
```json title="请求示例"
{
"op": "subscribe",
"args": [
{
"instType": "USDT-FUTURES",
"channel": "orders",
"instId": "default"
}
]
}
```
### 请求参数
| 参数名 | 参数类型 | 是否必须 | 描述 |
| :---- | :---- | :---- |:----------------------------------------------------------------------------------|
| op | String | 是 | 操作, subscribe unsubscribe |
| args | List<Object> | 是 | 请求订阅的频道列表 |
| > channel | String | 是 | 频道名 |
| > instType | String | 是 | 产品类型
`USDT-FUTURES` U本位合约
`COIN-FUTURES` 币本位合约
`USDC-FUTURES` USDC合约 |
| > instId | String | 否 | 交易对，如BTCUSDT
`defalut`代表订阅所有交易对
交割合约只支持`default` |
```json title="订阅返回示例"
{
"event": "subscribe",
"arg": {
"instType": "USDT-FUTURES",
"channel": "orders",
"instId": "default"
}
}
```
### 返回参数
| 返回字段 | 参数类型 | 字段说明 |
| :---- | :---- |:----------------------------------------------------------------------------------|
| event | String | 事件 |
| arg | Object | 订阅的频道 |
| > channel | String | 频道名 |
| > instType | String | 产品类型
`USDT-FUTURES` U本位合约
`COIN-FUTURES` 币本位合约
`USDC-FUTURES` USDC合约 |
| > instId | String | 产品id |
| code | String | 错误码 |
| msg | String | 错误消息 |
```json title="推送返回示例"
{
"data": [
{
"leverage": "12",
"orderType": "limit",
"presetStopLossType": "fill_price",
"tradeSide": "open",
"orderId": "13333333333333333",
"presetStopSurplusExecutePrice": "3200",
"feeDetail": [
{
"feeCoin": "USDT",
"fee": "0.00000000"
}
],
"cTime": "1760461517274",
"posMode": "hedge_mode",
"marginMode": "crossed",
"presetStopLossExecutePrice": "2800",
"posSide": "long",
"price": "3000",
"enterPointSource": "API",
"cancelReason": "",
"accBaseVolume": "0",
"stpMode": "none",
"side": "buy",
"totalProfits": "0",
"marginCoin": "USDT",
"notionalUsd": "1200",
"instId": "ETHUSDT",
"presetStopSurplusPrice": "3200",
"size": "0.4",
"reduceOnly": "no",
"presetStopLossPrice": "2800",
"force": "gtc",
"uTime": "1760461517274",
"presetStopSurplusType": "fill_price",
"clientOid": "12354678990111",
"status": "live"
}
],
"arg": {
"instType": "USDT-FUTURES",
"instId": "default",
"channel": "orders"
},
"action": "snapshot",
"ts": 1760461517285
}
```
### 推送数据参数
| 返回字段 | 参数类型 | 字段说明 |
|:-----------------------------------|:-------------------|:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| action | String | 推送动作, `snapshot` or `update` |
| arg | Object | 订阅成功的频道 |
| > channel | String | 频道名 |
| > instType | String | 产品类型
`USDT-FUTURES` U本位合约
`COIN-FUTURES` 币本位合约
`USDC-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 | 交易方向
`open` 开（开平仓模式）
`close` 平（开平仓模式）
`reduce_close_long` 双向持仓强制减多
`reduce_close_short` 双向持仓强制减空
`offset_close_long` 双向持仓轧差强制减多
`offset_close_short` 双向持仓轧差强制减空
`burst_close_long` 双向持仓爆仓平多
`burst_close_short` 双向持仓爆仓平空
`delivery_close_long` 双向持仓多头交割
`delivery_close_short` 双向持仓空头交割
`dte_sys_adl_close_long` 双向持仓ADL减多仓
`dte_sys_adl_close_short` 双向持仓ADL减空仓
`buy_single` 单向持仓买
`sell_single` 单向持仓卖
`reduce_buy_single` 单向持仓强制减仓买
`reduce_sell_single` 单向持仓强制减仓卖
`burst_buy_single` 单向持仓爆仓买
`burst_sell_single` 单向持仓爆仓卖
`delivery_sell_single` 单向持仓交割卖
`delivery_buy_single` 单向持仓交割买
`dte_sys_adl_buy_in_single_side_mode` 单向持仓ADL减仓买
`dte_sys_adl_sell_in_single_side_mode` 单向持仓ADL减仓卖 |
| > 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 已撤销 |
| > cancelReason | String | 取消原因
`normal_cancel` 普通取消
`stp_cancel` 因STP规则取消 |
| > 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` 两者都取消 |
| > totalProfits | String | 总盈亏 |
| > presetStopSurplusPrice | String | 预设止盈值 |
| > presetStopLossPrice | String | 预设止损值 |
| > presetStopSurplusExecutePrice | String | 预设止盈执行价格 |
| > presetStopLossExecutePrice | String | 预设止损执行价格 |