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:
- 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 - No snapshot of historical fills is pushed after subscription
- Fills in
dataare sorted bytsin 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
Request Parameters
| Parameters | Type | Required | Description |
|---|---|---|---|
| op | String | Yes | Operation subscribe Subscribe unsubscribe Unsubscribe |
| args | List<Object> | Yes | Subscribed channel |
| > instType | String | Yes | Product type Fixed to UTA |
| > topic | String | Yes | Topic Fixed to reality-fills |
| > symbol | String | Yes | Symbol name e.g., RAAPLUSDT. Only Reality trading pairs are supported |
Code
Response Parameters
| Parameters | Type | Description |
|---|---|---|
| event | String | Event subscribe Subscribe unsubscribe Unsubscribe error Error |
| arg | Object | Subscribed channel |
| > instType | String | Product type Fixed to UTA |
| > topic | String | Topic Fixed to reality-fills |
| > symbol | String | Symbol name |
| code | String | Error code |
| msg | String | Error message |
Code
Push Parameters
| Return Field | Parameter Type | Description |
|---|---|---|
| arg | Object | Subscribed channel |
| > instType | String | Product type Fixed to UTA |
| > topic | String | Topic Fixed to reality-fills |
| > symbol | String | Symbol name |
| action | String | Data push action Fixed to update Incremental fills |
| ts | String | Data push timestamp A Unix timestamp in milliseconds |
| data | List<Object> | Fill list, sorted by ts in descending order |
| > symbol | String | Symbol name |
| > execId | String | Fill ID Same as the REST APIs; can be used for de-duplication |
| > price | String | Fill price |
| > size | String | Fill quantity Unit: base coin |
| > side | String | Taker side buy Taker buy sell Taker sell |
| > execVenue | String | Execution 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 |
| > ts | String | Fill time A Unix timestamp in milliseconds |
