Historical data
GET/v1/ohlcv/exchange-symbol/:exchange_id/:symbol_id/history
Get OHLCV timeseries data returned in time ascending order.
Request
Path Parameters
Exchange identifier of requested timeseries (from the Metadata -> Exchanges)
Symbol identifier of requested timeseries (from the Metadata -> Symbols)
Query Parameters
Identifier of requested timeseries period (e.g. 5SEC
or 2MTH
)
Timeseries starting time in ISO 8601
Timeseries ending time in ISO 8601
Default value: 100
Amount of items to return (mininum is 1, maximum is 100000, default value is 100, if the parameter is used then every 100 output items are counted as one request)
Responses
- 200
successful operation
- text/plain
- application/json
- text/json
- Schema
- Example (from schema)
- Example response
Schema
Array [
]
Gets or sets the start time of the time period.
Gets or sets the end time of the time period.
Gets or sets the time when the price opened.
Gets or sets the time when the price closed.
Gets or sets the opening price.
Gets or sets the highest price during the time period.
Gets or sets the lowest price during the time period.
Gets or sets the closing price.
Gets or sets the total volume traded during the time period.
Gets or sets the number of trades executed during the time period.
[
{
"time_period_start": "2025-04-29T06:11:29.409Z",
"time_period_end": "2025-04-29T06:11:29.409Z",
"time_open": "2025-04-29T06:11:29.409Z",
"time_close": "2025-04-29T06:11:29.409Z",
"price_open": 0,
"price_high": 0,
"price_low": 0,
"price_close": 0,
"volume_traded": 0,
"trades_count": 0
}
]
[
{
"time_period_start": "2017-01-01T00:00:00.0000000Z",
"time_period_end": "2017-01-02T00:00:00.0000000Z",
"time_open": "2017-01-01T00:01:08.0000000Z",
"time_close": "2017-01-01T23:59:46.0000000Z",
"price_open": 966.34,
"price_high": 1005,
"price_low": 960.53,
"price_close": 997.75,
"volume_traded": 6850.59330859,
"trades_count": 7815
},
{
"time_period_start": "2017-01-02T00:00:00.0000000Z",
"time_period_end": "2017-01-03T00:00:00.0000000Z",
"time_open": "2017-01-02T00:00:05.0000000Z",
"time_close": "2017-01-02T23:59:37.0000000Z",
"price_open": 997.75,
"price_high": 1032,
"price_low": 990.01,
"price_close": 1012.54,
"volume_traded": 8167.38103018,
"trades_count": 7871
}
]
- Schema
- Example (from schema)
- Example response
Schema
Array [
]
Gets or sets the start time of the time period.
Gets or sets the end time of the time period.
Gets or sets the time when the price opened.
Gets or sets the time when the price closed.
Gets or sets the opening price.
Gets or sets the highest price during the time period.
Gets or sets the lowest price during the time period.
Gets or sets the closing price.
Gets or sets the total volume traded during the time period.
Gets or sets the number of trades executed during the time period.
[
{
"time_period_start": "2025-04-29T06:11:29.409Z",
"time_period_end": "2025-04-29T06:11:29.409Z",
"time_open": "2025-04-29T06:11:29.409Z",
"time_close": "2025-04-29T06:11:29.409Z",
"price_open": 0,
"price_high": 0,
"price_low": 0,
"price_close": 0,
"volume_traded": 0,
"trades_count": 0
}
]
[
{
"time_period_start": "2017-01-01T00:00:00.0000000Z",
"time_period_end": "2017-01-02T00:00:00.0000000Z",
"time_open": "2017-01-01T00:01:08.0000000Z",
"time_close": "2017-01-01T23:59:46.0000000Z",
"price_open": 966.34,
"price_high": 1005,
"price_low": 960.53,
"price_close": 997.75,
"volume_traded": 6850.59330859,
"trades_count": 7815
},
{
"time_period_start": "2017-01-02T00:00:00.0000000Z",
"time_period_end": "2017-01-03T00:00:00.0000000Z",
"time_open": "2017-01-02T00:00:05.0000000Z",
"time_close": "2017-01-02T23:59:37.0000000Z",
"price_open": 997.75,
"price_high": 1032,
"price_low": 990.01,
"price_close": 1012.54,
"volume_traded": 8167.38103018,
"trades_count": 7871
}
]
- Schema
- Example (from schema)
- Example response
Schema
Array [
]
Gets or sets the start time of the time period.
Gets or sets the end time of the time period.
Gets or sets the time when the price opened.
Gets or sets the time when the price closed.
Gets or sets the opening price.
Gets or sets the highest price during the time period.
Gets or sets the lowest price during the time period.
Gets or sets the closing price.
Gets or sets the total volume traded during the time period.
Gets or sets the number of trades executed during the time period.
[
{
"time_period_start": "2025-04-29T06:11:29.409Z",
"time_period_end": "2025-04-29T06:11:29.409Z",
"time_open": "2025-04-29T06:11:29.409Z",
"time_close": "2025-04-29T06:11:29.409Z",
"price_open": 0,
"price_high": 0,
"price_low": 0,
"price_close": 0,
"volume_traded": 0,
"trades_count": 0
}
]
[
{
"time_period_start": "2017-01-01T00:00:00.0000000Z",
"time_period_end": "2017-01-02T00:00:00.0000000Z",
"time_open": "2017-01-01T00:01:08.0000000Z",
"time_close": "2017-01-01T23:59:46.0000000Z",
"price_open": 966.34,
"price_high": 1005,
"price_low": 960.53,
"price_close": 997.75,
"volume_traded": 6850.59330859,
"trades_count": 7815
},
{
"time_period_start": "2017-01-02T00:00:00.0000000Z",
"time_period_end": "2017-01-03T00:00:00.0000000Z",
"time_open": "2017-01-02T00:00:05.0000000Z",
"time_close": "2017-01-02T23:59:37.0000000Z",
"price_open": 997.75,
"price_high": 1032,
"price_low": 990.01,
"price_close": 1012.54,
"volume_traded": 8167.38103018,
"trades_count": 7871
}
]