Historical data
GET/v1/ohlcv/:symbol_id/history
Get OHLCV timeseries data returned in time ascending order. Data can be requested by the period and for the specific symbol eg BITSTAMP_SPOT_BTC_USD
, if you need to query timeseries by asset pairs eg. BTC/USD
, then please reffer to the Exchange Rates Timeseries data
The OHLCV Historical endpoint data can be delayed a few seconds. Use OHLCV Latest endpoint to get real-time data without delay.
Request
Path Parameters
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)
Include items with no activity? (default value is false
, possible values are true
or false
)
Responses
- 200
successful operation
- text/plain
- application/json
- text/json
- application/x-msgpack
- Schema
- Example (from schema)
- Example response
Schema
Array [
]
The start time of the time period.
The end time of the time period.
The time when the price opened.
The time when the price closed.
The opening price.
The highest price during the time period.
The lowest price during the time period.
The closing price.
The total volume traded during the time period.
The number of trades executed during the time period.
[
{
"time_period_start": "2024-11-12T12:17:30.358Z",
"time_period_end": "2024-11-12T12:17:30.358Z",
"time_open": "2024-11-12T12:17:30.358Z",
"time_close": "2024-11-12T12:17:30.358Z",
"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 [
]
The start time of the time period.
The end time of the time period.
The time when the price opened.
The time when the price closed.
The opening price.
The highest price during the time period.
The lowest price during the time period.
The closing price.
The total volume traded during the time period.
The number of trades executed during the time period.
[
{
"time_period_start": "2024-11-12T12:17:30.358Z",
"time_period_end": "2024-11-12T12:17:30.358Z",
"time_open": "2024-11-12T12:17:30.358Z",
"time_close": "2024-11-12T12:17:30.358Z",
"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 [
]
The start time of the time period.
The end time of the time period.
The time when the price opened.
The time when the price closed.
The opening price.
The highest price during the time period.
The lowest price during the time period.
The closing price.
The total volume traded during the time period.
The number of trades executed during the time period.
[
{
"time_period_start": "2024-11-12T12:17:30.358Z",
"time_period_end": "2024-11-12T12:17:30.358Z",
"time_open": "2024-11-12T12:17:30.358Z",
"time_close": "2024-11-12T12:17:30.358Z",
"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 [
]
The start time of the time period.
The end time of the time period.
The time when the price opened.
The time when the price closed.
The opening price.
The highest price during the time period.
The lowest price during the time period.
The closing price.
The total volume traded during the time period.
The number of trades executed during the time period.
[
{
"time_period_start": "2024-11-12T12:17:30.358Z",
"time_period_end": "2024-11-12T12:17:30.358Z",
"time_open": "2024-11-12T12:17:30.358Z",
"time_close": "2024-11-12T12:17:30.358Z",
"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
}
]