订单

描述

订阅订单频道

以下事件发生时推送数据：

首次订阅,不推送
统一账户现货/杠杆/合约委托单下单,推送
统一账户现货/杠杆/合约委托单成交,推送
统一账户现货/杠杆/合约委托单撤单,推送

请求示例
{
    "op": "subscribe",
    "args": [
        {
            "instType": "UTA",
            "topic": "order"
        }
    ]
}

请求参数

参数名	参数类型	是否必须	描述
op	String	是	操作: `subscribe` 订阅 `unsubscribe` 取消订阅
args	List<Object>	是	请求订阅的频道列表
> instType	String	是	产品类型 `UTA` 统一账户
> topic	String	是	频道名: `order` 订单

订阅返回示例
{
  "event": "subscribe",
  "arg": {
    "instType": "UTA",
    "topic": "order"
  }
}

返回参数说明

返回字段	参数类型	字段说明
event	String	操作 `subscribe` 订阅 `unsubscribe` 退订 `error` 参数错误
arg	Object	订阅的频道
> instType	String	产品类型 `UTA` 统一账户
> topic	String	频道名 `order` 订单频道
code	String	错误码
msg	String	错误消息

推送返回示例
{
  "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",
      "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<String>	订阅的数据
> 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
> side	String	订单方向 `buy`: 买 `sell`: 卖
> holdSide	String	持仓方向 `long`: 双向持仓多头 `short`: 双向持仓空头 `net`: 单向持仓
> marginMode	String	保证金模式 `crossed`: 全仓模式 `isolated`: 逐仓模式
> reduceOnly	String	是否只减仓 `yes`: 是 `no` : 否
> marginCoin	String	保证金币种
> cumExecQty	String	累计成交数量
> cumExecValue	String	累计成交金额
> avgPrice	String	平均成交价若未成交，该字段也为0
> totalProfit	String	订单总盈亏
> orderStatus	String	订单状态 `live`: 订单已创建 `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`：两者都取消

订单

描述​

请求参数​

返回参数说明​

推送参数说明​

您的阅读体验如何？

描述

请求参数

返回参数说明

推送参数说明