Bitget APIBitget API
统一账户经典账户
旧文档
  • 概览
  • API 文档
  • WebSocket
  • Agent Hub
  • SDK
  • 更新日志
Copied to clipboard
Websocket
公共频道
私有频道
    下单撤单修改订单订单成交快速成交批量下单批量撤单批量修改订单账户持仓ADL通知策略订单频道
Reality
SBE
私有频道

成交

描述

实时推送用户成交信息

推送规则:

  1. 首次订阅不推送
  2. 统一账户现货/杠杆/合约委托单成交,推送
Code
{ "op": "subscribe", "args": [ { "instType": "UTA", "topic": "fill" } ] }

请求参数说明

参数名参数类型是否必须描述
opString是操作:
subscribe 订阅
unsubscribe 取消订阅
argsList<Object>是请求订阅的频道列表
> instTypeString是产品类型
UTA 统一账户
> topicString是频道名: fill 成交
Code
{ "event": "subscribe", "arg": { "instType": "UTA", "topic": "fill" }, "connId": "xxxxxxxxxx" }

返回参数说明

返回字段参数类型字段说明
eventString操作
subscribe 订阅
unsubscribe 退订
error 参数错误
argObject订阅的频道
> instTypeString产品类型
UTA 统一账户
> topicString频道名
fill 成交
codeString错误码
msgString错误消息
connIdString连接ID
Code
{ "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", "isRPI": "no" } ], "arg": { "instType": "UTA", "topic": "fill" }, "action": "snapshot", "ts": 1736378720653 }

推送参数说明

属性名类型描述
argObject订阅成功频道
> instTypeString产品线类型
UTA统一账户
> topicString频道名
fill成交频道
actionString推送数据动作
snapshot全量
dataList<Object>订阅的数据
> categoryString业务线
spot现货交易
margin 杠杆交易
usdt-futures U本位合约
coin-futures 币本位合约
usdc-futures USDC合约
> orderIdString订单ID
> clientOidString客户端订单ID
> execIdString成交ID
> execLinkIdString成交关联ID
> symbolString交易对名称
> orderTypeString订单类型
limit :限价
market : 市价
> sideString委托方向
buy: 买
sell: 卖
> holdSideString持仓方向
long:多
short :空
> tradeSideString交易方向
open: 开
close : 平
详细枚举可以在 枚举 页面获取
> execPriceString成交价格
> execQtyString成交数量
> execValueString成交总额
> execPnlString成交盈亏
> tradeScopeString交易者标识
taker: 吃单方
maker: 挂单方
> feeDetailString手续费明细
>> feeCoinString手续费币种
>> feeString总计手续费
> execTimeString成交时间
Unix毫秒时间戳,例如1622697148123
> updatedTimeString更新时间
Unix毫秒时间戳,例如1622697148123
> isRPIString是否为RPI类型成交
yes 是
no 否
订单快速成交
JSON
JSON
JSON