Retrieves the historical (time series) trade data for the specified pair.
Deprecation Notice
This endpoint is now considered a legacy version and will be deprecated on June 28, 2024. We strongly encourage all users to migrate to the new version of this endpoint for improved performance, enhanced features, and better support. The new version can be found here.
For details on the new versioning, please visit this page here. We recommend updating your applications at the earliest convenience to ensure uninterrupted service and access to the latest functionalities.
For any questions or assistance during migration, please contact our support team at [email protected].
Time Range Limit
The maximum time range (difference between startDate and endDate) is 1 hour.
In order to get more than the maximum allowed, you can use the
startDate&endDateparameters to move the time frame window to get the next n days/hours/minutes of data.
Not specifying startDate and endDate
If the startDate and endDate query parameters are not provided, the API will return the data from the previous hour.
Response Data
| Field | Type | Description |
|---|---|---|
| data | object | The trade data corresponding to the columns fields. |
| [EXCHANGE] | array | The array containing arrays of trade data. |
| metadata | object | The metadata associated with the trade data. |
| columns | array | The name of the columns associated with the returned data e.g. [ timestamp, tradeId, ...]. |
| timestamp | number | string | The timestamp at which the trade was executed. |
| timestampNanoseconds | number | The nanosecond part of the timestamp where applicable. |
| isBuy | boolean | true if the trade is a buy, false otherwise. |
| price | number | The price at which the asset was traded. |
| volume | number | The total amount of that asset that was traded. |
| tradeId | number | string | The exchange provided id of the trade. |