Get Trade History

from_timestamp  integer
Earliest timestamp to filter by (in ms since Unix epoch). If not provied, defaults to 0.

instrument_name  string
Instrument name to filter by

order_id  string
Order id to filter by

page  integer
Page number of results to return (default 1, returns last if above num_pages)

page_size  integer
Number of results per page (default 100, max 1000)

quote_id  string
If supplied, quote id to filter by. Supports either a concrete UUID, or is_quote and is_not_quote enum

subaccount_id  integer
Subaccount_id (must be set if wallet is blank)

to_timestamp  integer
Latest timestamp to filter by (in ms since Unix epoch). If not provied, defaults to returning all data up to current time.

wallet  string
Wallet address (if set, subaccount_id ignored)

id  string or integer required

result  object required

result. subaccount_id  integer required
Subaccount ID requested, or 0 if not provided

result. pagination  object required
Pagination info

result.pagination. count  integer required
Total number of items, across all pages

result.pagination. num_pages  integer required
Number of pages

result. trades  array of objects required
List of trades

result.trades[]. direction  string required
Order direction
enum buy sell

result.trades[]. expected_rebate  string required
Expected rebate for this trade

result.trades[]. index_price  string required
Index price of the underlying at the time of the trade

result.trades[]. instrument_name  string required
Instrument name

result.trades[]. is_transfer  boolean required
Whether the trade was generated through private/transfer_position

result.trades[]. label  string required
Optional user-defined label for the order

result.trades[]. liquidity_role  string required
Role of the user in the trade
enum maker taker

result.trades[]. mark_price  string required
Mark price of the instrument at the time of the trade

result.trades[]. order_id  string required
Order ID

result.trades[]. quote_id  string or null required
Quote ID if the trade was executed via RFQ

result.trades[]. realized_pnl  string required
Realized PnL for this trade

result.trades[]. realized_pnl_excl_fees  string required
Realized PnL for this trade using cost accounting that excludes fees

result.trades[]. subaccount_id  integer required
Subaccount ID

result.trades[]. timestamp  integer required
Trade timestamp (in ms since Unix epoch)

result.trades[]. trade_amount  string required
Amount filled in this trade

result.trades[]. trade_fee  string required
Fee for this trade

result.trades[]. trade_id  string required
Trade ID

result.trades[]. trade_price  string required
Price at which the trade was filled

result.trades[]. transaction_id  string required
The transaction id of the related settlement transaction

result.trades[]. tx_hash  string or null required
Blockchain transaction hash

result.trades[]. tx_status  string required
Blockchain transaction status
enum requested pending settled reverted ignored timed_out