get https://web3api.io/api/v2/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&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 previous 12 months of daily data.
Response Data
| Field | Type | Description |
|---|---|---|
| metadata | object | The metadata associated with the ohlcv data. |
| metadata.columns | array | The name of the columns associated with the returned data e.g. [instrument, timestamp, open, ...]. |
| metadata.startDate | number | string | The first date/time for which data is available. |
| metadata.endDate | number | string | The last date/time for which data is available. |
| data | object | |
| data.[pair] | array | The ohlcv data corresponding to the columns fields. |
| data.[pair].timestamp | string | The timestamp associated with this record. |
| data.[pair].open | number | The opening price of the market pair. |
| data.[pair].high | number | The highest price of the market pair. |
| data.[pair].low | number | The lowest price of the market pair. |
| data.[pair].close | number | The closing price of the market pair. |
| data.[pair].volume | number | The volume traded in within the time period. |