Provides historical trade data for futures instruments, including timestamps, trade prices, volumes, buy/sell side information, and trade identifiers across exchanges.
Time Range Limit
The maximum time range (difference between startDate and endDate) is 731 days (2 years).
Not specifying startDate and endDate
If the startDate and endDate query parameters are not provided, the API will return the data from the previous 24 hours.
🚨 Important Notice for BitMEX Data 🚨
BitMEX’s volume field represents the number of contracts traded, not the volume in the base asset. To obtain the correct volume, users must adjust for contract size using underlyingToPositionMultiplier from our Reference endpoint.
For details on this calculation and how to retrieve the correct values, see our Changelog Update.
RESPONSE DATA
| JSON Field/Path | Value Type | Description |
|---|---|---|
| payload.metadata.next | string | The URL for the next page of data (nullable if there is no next page). |
| payload.metadata.api-version | string | The version of the API used for this request. |
| payload.data[].instrument | string | The instrument or trading pair for which trade data is recorded (e.g., BTCUSD_PERP). |
| payload.data[].exchange | string | The name of the exchange where the trade data applies (e.g., binance). |
| payload.data[].exchangeTimestamp | integer | The timestamp from the exchange when the trade was executed, in milliseconds since epoch. |
| payload.data[].exchangeTimestampNanoseconds | integer | The nanoseconds part of the timestamp, representing sub-second precision. |
| payload.data[].isBuySide | boolean | Indicates whether the trade was on the buy side (true) or sell side (false). |
| payload.data[].price | float | The price at which the trade was executed. |
| payload.data[].volume | float | The volume of the trade. |
| payload.data[].tradeId | string | The unique identifier for the trade. |
| payload.data[].quoteVolume | float | The quote volume for the trade (nullable if not available). |
| payload.data[].sequence | string | The sequence number of the trade event (nullable if not available). |