API Reference

(Subaccount Id) Trades (Tx Status)

Channel Name Schema

{subaccount_id}.trades.{tx_status}

Subscribe to user's trade settlement for a given subaccount ID.

Channel Parameters

subaccount_id integer required
Subaccount ID
tx_status string required
Transaction status (settled or reverted)
enum settled reverted timed_out

Notification Data

channel string required
Subscribed channel name
data array of objects required
data[].direction string required
Order direction
enum buy sell
data[].index_price string required
Index price of the underlying at the time of the trade
data[].instrument_name string required
Instrument name
data[].is_transfer boolean required
Whether the trade was generated through private/transfer_position
data[].label string required
Optional user-defined label for the order
data[].liquidity_role string required
Role of the user in the trade
enum maker taker
data[].mark_price string required
Mark price of the instrument at the time of the trade
data[].order_id string required
Order ID
data[].quote_id string or null required
Quote ID if the trade was executed via RFQ
data[].realized_pnl string required
Realized PnL for this trade
data[].realized_pnl_excl_fees string required
Realized PnL for this trade using cost accounting that excludes fees
data[].subaccount_id integer required
Subaccount ID
data[].timestamp integer required
Trade timestamp (in ms since Unix epoch)
data[].trade_amount string required
Amount filled in this trade
data[].trade_fee string required
Fee for this trade
data[].trade_id string required
Trade ID
data[].trade_price string required
Price at which the trade was filled
data[].transaction_id string required
The transaction id of the related settlement transaction
data[].tx_hash string or null required
Blockchain transaction hash
data[].tx_status string required
Blockchain transaction status
enum requested pending settled reverted ignored timed_out

Example

Subscriptions are only available via websockets.

{request_example_javascript}
{request_example_python}

Notification messages on this channel will look like this:

{response_example_json}