# 订单
### 描述
订阅订单频道
以下事件发生时推送数据：
1. 首次订阅,不推送
2. 统一账户现货/杠杆/合约委托单下单,推送
3. 统一账户现货/杠杆/合约委托单成交,推送
4. 统一账户现货/杠杆/合约委托单撤单,推送
```json title="请求示例"
{
"op": "subscribe",
"args": [
{
"instType": "UTA",
"topic": "order"
}
]
}
```
### 请求参数
| 参数名 | 参数类型 | 是否必须 | 描述 |
|:--------------|:-------------------|------|:-------------------------------------------------|
| op | String | 是 | 操作:
`subscribe` 订阅
`unsubscribe` 取消订阅 |
| args | List<Object> | 是 | 请求订阅的频道列表 |
| > instType | String | 是 | 产品类型
`UTA` 统一账户 |
| > topic | String | 是 | 频道名: `order` 订单 |
```json title="订阅返回示例"
{
"event": "subscribe",
"arg": {
"instType": "UTA",
"topic": "order"
},
"connId": "xxxxxxxxxx"
}
```
### 返回参数说明
| 返回字段 | 参数类型 | 字段说明 |
|:--------------|:-------|:----------------------------------------------------------------|
| event | String | 操作
`subscribe` 订阅
`unsubscribe` 退订
`error` 参数错误 |
| arg | Object | 订阅的频道 |
| > instType | String | 产品类型
`UTA` 统一账户 |
| > topic | String | 频道名
`order` 订单频道 |
| code | String | 错误码 |
| msg | String | 错误消息 |
| connId | String | 连接ID |
```json title="推送返回示例"
{
"action": "snapshot",
"arg": {
"instType": "UTA",
"topic": "order"
},
"data": [
{
"category": "usdt-futures",
"symbol": "BTCUSDT",
"orderId": "xxx",
"clientOid": "xxx",
"price": "",
"qty": "0.001",
"amount": "1000",
"holdMode": "hedge_mode",
"holdSide": "long",
"delegateType": "normal",
"tradeSide": "open",
"orderType": "market",
"timeInForce": "gtc",
"side": "buy",
"marginMode": "crossed",
"marginCoin": "USDT",
"reduceOnly": "no",
"cumExecQty": "0.001",
"cumExecValue": "83.1315",
"avgPrice": "83131.5",
"totalProfit": "0",
"orderStatus": "filled",
"cancelReason": "",
"leverage": "20",
"feeDetail": [
{
"feeCoin": "USDT",
"fee": "0.0332526"
}
],
"createdTime": "1742367838101",
"updatedTime": "1742367838115",
"stpMode": "none"
}
],
"ts": 1742367838124
}
```
### 推送参数说明
| 返回字段 | 参数类型 | 字段说明 |
|:------------------|:-------------------|:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| arg | Object | 订阅成功频道 |
| > instType | String | 产品线类型
`UTA`统一账户 |
| > topic | String | 频道名
`order`订单频道 |
| action | String | 推送数据动作
`snapshot`全量 |
| data | List<Object> | 订阅的数据 |
| > category | String | 业务线
`spot`现货交易
`margin` 杠杆交易
`usdt-futures` U本位合约
`coin-futures` 币本位合约
`usdc-futures` USDC合约 |
| > symbol | String | 交易对名称 |
| > orderId | String | 订单ID |
| > clientOid | String | 自定义订单ID |
| > price | String | 委托价格 |
| > qty | String | 委托数量 |
| > amount | String | 委托金额 |
| > holdMode | String | 持仓模式
`one_way_mode`: 单向持仓
`hedge_mode`: 双向持仓 |
| > tradeSide | String | 交易方向
`open`: 开
`close` : 平
详细枚举可以在 枚举 页面获取 |
| > orderType | String | 订单类型
`limit` : 限价
`market` : 市价 |
| > timeInForce | String | 订单执行策略
`ioc`: 无法立即成交的部分就撤销
`fok`: 无法全部立即成交就撤销
`gtc`: 普通订单, 订单会一直有效，直到被成交或者取消
`post_only`: 只做maker
`rpi`: 零售价格优化订单 |
| > side | String | 订单方向
`buy`: 买
`sell`: 卖 |
| > holdSide | String | 持仓方向
`long`: 多头
`short`: 空头 |
| > delegateType | String | 委托类型
`normal`: 限价普通
`stop_profit_market`: 最优价止盈
`stop_loss_market`: 最优价止损
`stop_profit_chase`: 止盈追价委托
`stop_loss_chase`: 止损追价委托
`trader_delegate`: 带单委托
`trader_stop_profit`: 带单止盈
`trader_stop_loss`: 带单止损
`follower_delegate`: 跟单委托
`reduce_offset_delegate`: 减仓扎差委托
`market`: 最优价普通
`market_risk`: 最优价风险处理
`plan_limit`: 限价计划委托
`plan_market`: 最优价计划委托
`back_contract`: 反手
`trader_back_contract`: 带单反手
`strategy_grid_positive`: 策略-正向网格
`strategy_grid_reverse`: 策略-反向网格
`strategy_unlimited`: 无限策略
`stop_profit_limit`: 限价止盈
`stop_loss_limit`: 限价止损
`move_stop_limit`: 限价移动止盈止损
`move_stop_market`: 最优价移动止盈止损
`position_stop_profit_limit`: 限价仓位止盈
`position_stop_profit_market`: 最优价仓位止盈
`position_stop_loss_limit`: 限价仓位止损
`position_stop_loss_market`: 最优价仓位止损
`tracking_plan_limit`: 限价追踪委托
`tracking_plan_market`: 最优价追踪委托
`delivery_close_long`: 多头交割
`delivery_close_short`: 空头交割
`liquidation`: 爆仓清算
`strategy_dca_positive`: DCA策略-正向
`strategy_dca_reverse`: DCA策略-反向
`spot_trace_trader_buy`: 现货带单买
`spot_trace_follower_buy`: 现货跟单买
`spot_trace_trader_sell`: 现货带单卖
`spot_trace_follower_sell`: 现货跟单卖
`strategy_oco_limit`: 策略-OCO限价单
`strategy_oco_trigger`: 策略-OCO触发单
`modify_limit_order`: 限价修改
`strategy_regular_buy`: 策略-定投策略买
`strategy_grid_middle`: 策略-中性网格
`strategy_cta_positive`: CTA策略-正向
`strategy_cta_reverse`: CTA策略-反向
`strategy_tpsl_limit`: 现货止盈止损限价单
`strategy_tpsl_market`: 现货止盈止损市价单
`strategy_contract_ai`: 合约AI智投
`strategy_trace_market`: 追踪委托市价单
`strategy_trace_limit`: 追踪委托限价单
`strategy_portfolio_buy`: 策略-囤币宝买
`strategy_portfolio_sell`: 策略-囤币宝卖
`strategy_tradingview`: TRADINGVIEW信号接入策略
`sigan_trace`: 信号跟单
`mmr_stop_loss_market`: 最优价MMR止损
`bbo_opponent1`: BBO-对手价1
`bbo_opponent5`: BBO-对手价5
`bbo_companion1`: BBO-同向价1
`bbo_companion5`: BBO-同向价5
`bbo_opponent1_profit`: BBO-对手价1止盈
`bbo_opponent5_profit`: BBO-对手价5止盈
`bbo_companion1_profit`: BBO-同向价1止盈
`bbo_companion5_profit`: BBO-同向价5止盈
`bbo_opponent1_loss`: BBO-对手价1止损
`bbo_opponent5_loss`: BBO-对手价5止损
`bbo_companion1_loss`: BBO-同向价1止损
`bbo_companion5_loss`: BBO-同向价5止损
`spot_bbo_opponent1_tpsl`: BBO-对手价1止盈止损
`spot_bbo_opponent5_tpsl`: BBO-对手价5止盈止损
`spot_bbo_companion1_tpsl`: BBO-同向价1止盈止损
`spot_bbo_companion5_tpsl`: BBO-同向价5止盈止损
`dummy_bbo_profit`: BBO-止盈
`dummy_bbo_loss`: BBO-止损
`strategy_pre_tpsl_limit`: 现货预设止盈止损限价单
`strategy_pre_tpsl_market`: 现货预设止盈止损市价单
`future_signal_delegate`: 合约喊单跟单限价单
`grant_market`: 体验券开仓
`tg_signal_limit`: TG信号单
`tg_signal_tp_market`: TG信号单止盈
`tg_signal_sl_market`: TG信号单止损
`strategy_preset_tpsl_limit`: 现货预设计划委托止盈止损限价单
`strategy_preset_tpsl_market`: 现货预设计划委托止盈止损市价单
`trader_iceberg_limit`: 冰山委托
`trader_time_share_market`: 分时委托
`strategy_arbitrage_positive`: 资金费套利策略正向
`strategy_arbitrage_reverse`: 资金费套利策略反向
`convert_hedging`: 闪兑操盘
`off_close`: 下架平仓
|
| > marginMode | String | 保证金模式
`crossed`: 全仓模式
`isolated`: 逐仓模式 |
| > reduceOnly | String | 是否只减仓
`yes`: 是 `no` : 否 |
| > marginCoin | String | 保证金币种 |
| > cumExecQty | String | 累计成交数量 |
| > cumExecValue | String | 累计成交金额 |
| > avgPrice | String | 平均成交价 若未成交，该字段也为0 |
| > totalProfit | String | 订单总盈亏 |
| > orderStatus | String | 订单状态
`new`: 订单已进入撮合
`partially_filled`: 部分成交
`filled`: 全部成交
`cancelled`: 已撤销 |
| > cancelReason | String | 订单取消原因
详细枚举可以在 枚举 页面获取 |
| > leverage | String | 杠杆倍数 |
| > feeDetail | List | 手续费详情列表 |
| >> feeCoin | String | 手续费币种 |
| >> fee | String | 手续费数量 |
| > createdTime | String | 订单创建时间
Unix时间戳的毫秒数格式，如 1597026383085 |
| > updatedTime | String | 订单更新时间
Unix时间戳的毫秒数格式，如 1597026383085 |
| > stpMode | String | STP（自成交预防）模式
`none`：无STP设置
`cancel_taker`：取消taker单
`cancel_maker`：取消maker单
`cancel_both`：两者都取消 |