Sign in

v1

latestOpenAPI 3.0.32026-07-1492428.9 KB
Exchange

/exchange/trades

Retrieves recent trades executed on a market.

get/v1/exchange/trades

Query parameters

symbolstring required

The market symbol to get the trades for.

tradeType'ORDER' | 'LIQUIDATION' | 'DELEVERAGE' | 'UNSPECIFIED'

Type of trade.

Type of trade.

limitinteger

Default 500; max 1000.

startTimeAtMillisinteger

The timestamp specifies the earliest point in time for which data should be returned. The value is not included.

endTimeAtMillisinteger

The timestamp specifies the latest point in time for which data should be returned. The value is included.

pageinteger

The page number to retrieve in a paginated response.

Response

Recent trades

idstring required

Trade ID

clientOrderIdstring

Client order ID.

symbolstring

Market address.

orderHashstring

Order hash.

orderType'LIMIT' | 'MARKET' | 'STOP_LIMIT' | 'STOP_MARKET' | 'LIQUIDATION' | 'STOP_LOSS_MARKET' | 'TAKE_PROFIT_MARKET' | 'STOP_LOSS_LIMIT' | 'TAKE_PROFIT_LIMIT' | 'BANKRUPTCY_LIQUIDATION' | 'UNSPECIFIED'

The type of order. (BANKRUPTCY_LIQUIDATION is deprecated)

tradeType'ORDER' | 'LIQUIDATION' | 'DELEVERAGE' | 'UNSPECIFIED'

Type of trade.

side'LONG' | 'SHORT' | 'UNSPECIFIED' required

Trade side based on the user order in this trade.

isMakerboolean

Indicates if the user was a maker to the trade.

priceE9string required

Trade price (e9 format).

quantityE9string required

Trade quantity (e9 format).

quoteQuantityE9string required

Quote quantity (e9 format).

realizedPnlE9string

Realized profit and loss (e9 format).

positionSide'LONG' | 'SHORT' | 'UNSPECIFIED'

The side of the position, either long or short

tradingFeeE9string

Trading fee (e9 format).

tradingFeeAssetstring

Asset used for trading fee.

gasFeeE9string

Gas fee.

gasFeeAssetstring

Asset used for gas fee.

executedAtMillisinteger required

Trade timestamp in milliseconds since Unix epoch.

Example response

[
  {
    "id": 28457,
    "symbol": "0x123",
    "price": "4000001000",
    "quantityE9": "12000000000",
    "quoteQuantityE9": "48000012000",
    "side": "LONG",
    "timeAtMillis": 1499865549590,
    "txHash": "0x123456789abcdef"
  }
]