成交

描述

实时推送用户成交信息

推送规则：

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

请求示例

{
    "op": "subscribe",
    "args": [
        {
            "instType": "UTA",
            "topic": "fill"
        }
    ]
}

请求参数说明

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

订阅响应示例

{
  "event": "subscribe",
  "arg": {
    "instType": "UTA",
    "topic": "fill"
  }
}

返回参数说明

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

推送示例

{
  "data": [
    {
      "symbol": "BTCUSDT",
      "orderType": "market",
      "updatedTime": "1736378720623",
      "side": "buy",
      "orderId": "1288888888888888888",
      "execPnl": "0",
      "feeDetail": [
        {
          "feeCoin": "USDT",
          "fee": "0.569958"
        }
      ],
      "execTime": "1736378720623",
      "tradeScope": "taker",
      "tradeSide": "open",
      "execId": "1288888888888888888",
      "execLinkId": "1288888888888888888",
      "execPrice": "94993",
      "holdSide": "long",
      "execValue": "949.93",
      "category": "USDT-FUTURES",
      "execQty": "0.01",
      "clientOid": "1288888888888888889"
    }
  ],
  "arg": {
    "instType": "UTA",
    "topic": "fill"
  },
  "action": "snapshot",
  "ts": 1736378720653
}

推送参数说明

属性名	类型	描述
arg	Object	订阅成功频道
> instType	String	产品线类型 UTA统一账户
> topic	String	频道名 fill成交频道
action	String	推送数据动作 snapshot全量
data	List<String>	订阅的数据
> category	String	业务线 SPOT现货交易 MARGIN 杠杆交易 USDT-FUTURES U本位合约 COIN-FUTURES 币本位合约 USDC-FUTURES USDC合约
> orderId	String	订单ID
> clientOid	String	客户端订单ID
> execId	String	成交ID
> execLinkId	String	成交关联ID
> symbol	String	交易对名称
> orderType	String	订单类型 limit :限价 market : 市价
> side	String	委托方向 buy: 买 sell: 卖
> holdSide	String	持仓方向 long:多 short :空
> tradeSide	String	交易方向 open: 开 close : 平 详细枚举可以在 枚举 页面获取
> execPrice	String	成交价格
> execQty	String	成交数量
> execValue	String	成交总额
> execPnl	String	成交盈亏
> tradeScope	String	交易者标识 taker: 吃单方 maker: 挂单方
> feeDetail	String	手续费明细
>> feeCoin	String	手续费币种
>> fee	String	总计手续费
> execTime	String	成交时间 Unix毫秒时间戳，例如1622697148123
> updatedTime	String	更新时间 Unix毫秒时间戳，例如1622697148123