get https://api.amberdata.com/market/spot/ohlcv/exchange//historical
Retrieves the historical (time series) open-high-low-close for the specified exchange and pairs. Note: The timestamp returned refers to the start of the candle.
Time Range Limit
The maximum time range (difference between startDate and endDate) is:
- 12 months of daily data
- 30 days of hourly data
- 24 hours of minutely data
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.
Not specifying startDate and endDate
If the startDate and endDate query parameters are not provided, the API will return the previous 12 months of daily data.
RESPONSE DATA
JSON Field/Path | Field Type | Description |
---|---|---|
payload.metadata.columns | array | An array of strings that represents the columns returned in the OHLCV data. Typically includes "timestamp", "open", "high", "low", "close", and "volume". |
payload.metadata.startDate | number | The timestamp in milliseconds representing the start date for the historical OHLCV data range. |
payload.metadata.endDate | number | The timestamp in milliseconds representing the end date for the historical OHLCV data range. |
payload.data.{instrument}[{index}][0] | number | The timestamp in milliseconds for the OHLCV data at the specified index for the given instrument. |
payload.data.{instrument}[{index}][1] | number | The opening price of the trading pair at the specified timestamp. |
payload.data.{instrument}[{index}][2] | number | The highest price of the trading pair during the specified time period. |
payload.data.{instrument}[{index}][3] | number | The lowest price of the trading pair during the specified time period. |
payload.data.{instrument}[{index}][4] | number | The closing price of the trading pair at the specified timestamp. |
payload.data.{instrument}[{index}][5] | number | The total volume of the trading pair traded during the specified time period, in the base currency. |