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.
Path Parameters
- symbol_id string required
Symbol identifier of requested timeseries (from the Metadata -> Symbols)
Query Parameters
- period_id string
Identifier of requested timeseries period (required, e.g.
5SEC
or2MTH
) - time_start string
Timeseries starting time in ISO 8601 (required)
- time_end string
Timeseries ending time in ISO 8601 (optional, if not supplied then the data is returned to the end or when count of result elements reaches the limit)
- limit int32
Default value:
100
Amount of items to return (optional, 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_empty_items boolean
Include items with no activity? (optional, default value is
false
, possible values aretrue
orfalse
)
- 200
successful operation
- text/plain
- application/json
- text/json
- application/x-msgpack
- Schema
- Example (from schema)
- Example response
Schema
- Array [
- time_period_start date-time
The start time of the time period.
- time_period_end date-time
The end time of the time period.
- time_open date-time nullable
The time when the price opened.
- time_close date-time nullable
The time when the price closed.
- price_open double nullable
The opening price.
- price_high double nullable
The highest price during the time period.
- price_low double nullable
The lowest price during the time period.
- price_close double nullable
The closing price.
- volume_traded double
The total volume traded during the time period.
- trades_count int64
The number of trades executed during the time period.
- ]
[
{
"time_period_start": "2024-04-24T17:11:55.847Z",
"time_period_end": "2024-04-24T17:11:55.847Z",
"time_open": "2024-04-24T17:11:55.847Z",
"time_close": "2024-04-24T17:11:55.847Z",
"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 [
- time_period_start date-time
The start time of the time period.
- time_period_end date-time
The end time of the time period.
- time_open date-time nullable
The time when the price opened.
- time_close date-time nullable
The time when the price closed.
- price_open double nullable
The opening price.
- price_high double nullable
The highest price during the time period.
- price_low double nullable
The lowest price during the time period.
- price_close double nullable
The closing price.
- volume_traded double
The total volume traded during the time period.
- trades_count int64
The number of trades executed during the time period.
- ]
[
{
"time_period_start": "2024-04-24T17:11:55.848Z",
"time_period_end": "2024-04-24T17:11:55.848Z",
"time_open": "2024-04-24T17:11:55.848Z",
"time_close": "2024-04-24T17:11:55.848Z",
"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 [
- time_period_start date-time
The start time of the time period.
- time_period_end date-time
The end time of the time period.
- time_open date-time nullable
The time when the price opened.
- time_close date-time nullable
The time when the price closed.
- price_open double nullable
The opening price.
- price_high double nullable
The highest price during the time period.
- price_low double nullable
The lowest price during the time period.
- price_close double nullable
The closing price.
- volume_traded double
The total volume traded during the time period.
- trades_count int64
The number of trades executed during the time period.
- ]
[
{
"time_period_start": "2024-04-24T17:11:55.848Z",
"time_period_end": "2024-04-24T17:11:55.848Z",
"time_open": "2024-04-24T17:11:55.848Z",
"time_close": "2024-04-24T17:11:55.848Z",
"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 [
- time_period_start date-time
The start time of the time period.
- time_period_end date-time
The end time of the time period.
- time_open date-time nullable
The time when the price opened.
- time_close date-time nullable
The time when the price closed.
- price_open double nullable
The opening price.
- price_high double nullable
The highest price during the time period.
- price_low double nullable
The lowest price during the time period.
- price_close double nullable
The closing price.
- volume_traded double
The total volume traded during the time period.
- trades_count int64
The number of trades executed during the time period.
- ]
[
{
"time_period_start": "2024-04-24T17:11:55.848Z",
"time_period_end": "2024-04-24T17:11:55.848Z",
"time_open": "2024-04-24T17:11:55.848Z",
"time_close": "2024-04-24T17:11:55.848Z",
"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
}
]