Bitget APIBitget API
UTAClassic
Legacy Doc
  • Overview
  • API Documentation
  • WebSocket
  • Agent Hub
  • SDK
  • Changelog
Copied to clipboard
Websocket
Public
Private
Reality
    Public
      Reality Orderbook ChannelReality Orderbook Segmented ChannelReality Fills Channel
SBE
Public

Reality Fills Channel

Description

Pushes real-time, trade-by-trade rToken fill data, covering both internal fills (matched in the internal order book) and lit market fills (routed to an external broker). Each fill carries the execution venue execVenue.

Push rules:

  1. Fills are pushed trade by trade as update: each new fill is pushed in real time; nothing is pushed when there are no new fills
  2. No snapshot of historical fills is pushed after subscription
  3. Fills in data are sorted by ts in descending order

All fills are presented from the taker's perspective.

Notes

  • This channel requires API Key authentication, and please contact your BD in advance to apply for whitelist access.
  • This channel pushes platform public fills, not your own fills. For your own fills, use the private Fast Fill Channel.
  • The general public trades channel and REST API no longer return fills of Reality (rToken) trading pairs. Please migrate to this channel or Get Reality Fills.
Code
{ "op": "subscribe", "args": [ { "instType": "UTA", "topic": "reality-fills", "symbol": "RAAPLUSDT" } ] }

Request Parameters

ParametersTypeRequiredDescription
opStringYesOperation
subscribe Subscribe
unsubscribe Unsubscribe
argsList<Object>YesSubscribed channel
> instTypeStringYesProduct type
Fixed to UTA
> topicStringYesTopic
Fixed to reality-fills
> symbolStringYesSymbol name
e.g., RAAPLUSDT. Only Reality trading pairs are supported
Code
{ "event": "subscribe", "arg": { "instType": "UTA", "topic": "reality-fills", "symbol": "RAAPLUSDT" } }

Response Parameters

ParametersTypeDescription
eventStringEvent
subscribe Subscribe
unsubscribe Unsubscribe
error Error
argObjectSubscribed channel
> instTypeStringProduct type
Fixed to UTA
> topicStringTopic
Fixed to reality-fills
> symbolStringSymbol name
codeStringError code
msgStringError message
Code
{ "arg": { "instType": "UTA", "topic": "reality-fills", "symbol": "RAAPLUSDT" }, "action": "update", "ts": "1762052401056", "data": [ { "symbol": "RAAPLUSDT", "execId": "1234567893", "price": "227.48", "size": "10", "side": "sell", "execVenue": "lit_market", "ts": "1762052401050" } ] }

Push Parameters

Return FieldParameter TypeDescription
argObjectSubscribed channel
> instTypeStringProduct type
Fixed to UTA
> topicStringTopic
Fixed to reality-fills
> symbolStringSymbol name
actionStringData push action
Fixed to update Incremental fills
tsStringData push timestamp
A Unix timestamp in milliseconds
dataList<Object>Fill list, sorted by ts in descending order
> symbolStringSymbol name
> execIdStringFill ID
Same as the REST APIs; can be used for de-duplication
> priceStringFill price
> sizeStringFill quantity
Unit: base coin
> sideStringTaker side
buy Taker buy
sell Taker sell
> execVenueStringExecution venue
internal_market Internal fill: matched in the internal order book
lit_market Lit market fill: routed to an external broker and executed on the public market
Note: execVenue is where the fill actually took place, which differs from the venue order parameter
> tsStringFill time
A Unix timestamp in milliseconds
Reality Orderbook Segmented ChannelSBE Introduction
JSON
JSON
JSON