Bitget APIBitget API
统一账户经典账户
旧文档
  • 概览
  • API 文档
  • WebSocket
  • Agent Hub
  • SDK
  • 更新日志
Copied to clipboard
Websocket
介绍
合约
    公共频道
    私有频道
      账户频道权益频道成交明细持仓频道历史持仓频道订单频道计划委托频道撤销订单频道下单频道ADL通知
现货
杠杆
私有频道

成交明细

推送规则:首次订阅不推送,订单发生成交时推送

描述

订阅成交明细信息

推送规则:首次订阅不推送,订单发生成交时推送

Code
{ "op": "subscribe", "args": [ { "instType": "USDT-FUTURES", "channel": "fill", "instId": "default" } ] }

请求参数

参数名参数类型是否必须描述
opString是操作, subscribe unsubscribe
argsList<Object>是请求订阅的频道列表
> channelString是频道名
> instTypeString是产品类型
> instIdString否产品名或default,交割合约参考:https://www.bitget.com/zh-CN/api-doc/common/release-note
Code
{ "event": "subscribe", "arg": { "instType": "USDT-FUTURES", "channel": "fill", "instId": "default" } }

返回参数

返回字段参数类型字段说明
eventString事件
argObject订阅的频道
> channelString频道名
> instTypeString产品类型
> instIdString产品名或default
codeString错误码,错误时才会返回
msgString错误消息
Code
{ "action":"snapshot", "arg":{ "instType":"USDT-FUTURES", "channel":"fill", "instId":"default" }, "data":[ { "orderId":"111", "clientOid":"111", "tradeId":"222", "symbol":"BTCUSDT", "side":"buy", "orderType":"market", "posMode":"one_way_mode", "price":"51000.5", "baseVolume":"0.01", "quoteVolume":"510.005", "profit":"0", "tradeSide":"open", "tradeScope":"taker", "feeDetail":[ { "feeCoin":"USDT", "deduction":"no", "totalDeductionFee":"0", "totalFee":"-0.183717" } ], "cTime":"1703577336606", "uTime":"1703577336606" } ], "ts":1703577336700 }

推送数据参数

返回字段参数类型字段说明
actionString推送动作, 'snapshot'
argObject订阅成功的频道
> channelString频道名
> instTypeString产品类型
USDT-FUTURES U本位合约
COIN-FUTURES 币本位合约
USDC-FUTURES USDC合约
> instIdString产品ID
dataList<Object>订阅的数据
> orderIdString订单ID
> clientOidString自定义订单ID
> tradeIdString成交ID
> symbolString交易对名称
> sideString买卖方向
buy: 买
sell: 卖
注:对于此频道,双向持仓下, 开多、平空时为buy, 开空,平多时为sell
> orderTypeString订单类型
limit 限价单
market 市价单
> posModeString持仓模式
one_way_mode 单向持仓
hedge_mode 双向持仓
> priceString成交价格
> baseVolumeString基础币成交额
> quoteVolumeString计价币成交额
> profitString盈利
> tradeSideString交易类型
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减仓卖
> tradeScopeString交易者标识
taker: 吃单方
maker: 挂单方
> feeDetailList<Object>手续费明细
  >> deductionString是否折扣
  >> totalDeductionFeeString折扣手续费
  >> totalFeeString总手续费
  >> feeCoinString手续费币种
> cTimeString创建时间,Unix时间戳的毫秒数格式,如 1597026383085
> uTimeString更新时间,Unix时间戳的毫秒数格式,如 1597026383085
权益频道持仓频道
JSON
JSON
JSON