Events Historical

Retrieves the historical time series order book events (bid and ask) for the specified instrument and exchange(s).

Note: This endpoint returns a maximum of 1 hour of historical data per request. The parameters startDate and endDate can be used to specify any arbitrary time range.


Deprecation Notice

As part of our ongoing efforts to improve our API and services, we will be deprecating this endpoint on June 28, 2024. This decision is in line with our commitment to providing high-quality, efficient, and secure API services to our users.

We encourage all users of this endpoint to transition to the Futures Order Book Event endpoint as soon as possible. This endpoint offers the same data, we have simply merged our Swaps data together with the Futures data. Therefore, "Swaps" data (aka Perpetual Futures) can now be found under the Futures section of the Amberdata API docs.


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 & endDate parameters to move the time frame window to get the next n days/hours/minutes of data.

This endpoint is used to retrieve historical data only and is updated every hour. If your query does not return any data, try the hour before using the startDate & endDate parameters.


Not specifying startDate and endDate

If the startDate and endDate query parameters are not provided, the API will return the data from the previous 10 minutes.


{metadata}objectThe metadata associated with the data.
{metadata}.[columns]arrayThe name of the columns associated with the returned liquidation data.
{metadata}.startDatenumber | stringThe first date/time for which data is available.
{metadata}.endDatenumber | stringThe last date/time for which data is available.
[data]objectThe order book data corresponding to the columns fields, aggregated by exchange.
[data].exchangestringThe name of the exchange, as specified by the filter provided or representing the supported exchanges for this instrument.
[data].timestampnumber | stringThe time at which the event occurred.
[data].timestampNanosecondsnumberThe nanoseconds decimal part of the timestamp.
[data].isBidbooleantrue if the order is a bid, false otherwise.
[data].pricenumberPrice level in the order book.
[data].amountnumberThe number of contracts at the price level (an amount of zero indicates a delete from the order book).
Click Try It! to start a request and see the response here!