Historical data
GET/v1/quotes/:symbol_id/history
Get historical quote updates within requested time range, returned in time ascending order.
The 'time_start' and 'time_end' parameters must be from the same day as this endpoint provides intraday data only for specific day. Please use the 'date' parameter instead for querying data for a specific day without filter.
Request
Path Parameters
Symbol identifier for requested timeseries (from the Metadata -> Symbols)
Query Parameters
Date in ISO 8601, returned data is for the whole given day (preferred method, required if 'time_start' is not provided)
Starting time in ISO 8601
Timeseries ending time in ISO 8601
Default value: 100
Amount of items to return (optional, minimum 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
- application/x-msgpack
- Schema
- Example (from schema)
- Example response
Schema
Array [
]
The symbol identifier.
The exchange time of the quote.
The CoinAPI time when the quote was received.
The best asking price.
The volume resting on the best ask. If the value is equal to zero, then the size is unknown.
The best bidding price.
The volume resting on the best bid. If the value is equal to zero, then the size is unknown.
[
{
"symbol_id": "string",
"time_exchange": "2025-04-17T06:09:11.027Z",
"time_coinapi": "2025-04-17T06:09:11.027Z",
"ask_price": 0,
"ask_size": 0,
"bid_price": 0,
"bid_size": 0
}
]
[
{
"symbol_id": "BITSTAMP_SPOT_BTC_USD",
"time_exchange": "2013-09-28T22:40:50.0000000Z",
"time_coinapi": "2017-03-18T22:42:21.3763342Z",
"ask_price": 770,
"ask_size": 3252,
"bid_price": 760,
"bid_size": 124
},
{
"symbol_id": "BITSTAMP_SPOT_BTC_USD",
"time_exchange": "2013-09-28T22:40:50.0000000Z",
"time_coinapi": "2017-03-18T22:42:21.3763342Z",
"ask_price": 770,
"ask_size": 3252,
"bid_price": 760,
"bid_size": 124
}
]
- Schema
- Example (from schema)
- Example response
Schema
Array [
]
The symbol identifier.
The exchange time of the quote.
The CoinAPI time when the quote was received.
The best asking price.
The volume resting on the best ask. If the value is equal to zero, then the size is unknown.
The best bidding price.
The volume resting on the best bid. If the value is equal to zero, then the size is unknown.
[
{
"symbol_id": "string",
"time_exchange": "2025-04-17T06:09:11.027Z",
"time_coinapi": "2025-04-17T06:09:11.027Z",
"ask_price": 0,
"ask_size": 0,
"bid_price": 0,
"bid_size": 0
}
]
[
{
"symbol_id": "BITSTAMP_SPOT_BTC_USD",
"time_exchange": "2013-09-28T22:40:50.0000000Z",
"time_coinapi": "2017-03-18T22:42:21.3763342Z",
"ask_price": 770,
"ask_size": 3252,
"bid_price": 760,
"bid_size": 124
},
{
"symbol_id": "BITSTAMP_SPOT_BTC_USD",
"time_exchange": "2013-09-28T22:40:50.0000000Z",
"time_coinapi": "2017-03-18T22:42:21.3763342Z",
"ask_price": 770,
"ask_size": 3252,
"bid_price": 760,
"bid_size": 124
}
]
- Schema
- Example (from schema)
- Example response
Schema
Array [
]
The symbol identifier.
The exchange time of the quote.
The CoinAPI time when the quote was received.
The best asking price.
The volume resting on the best ask. If the value is equal to zero, then the size is unknown.
The best bidding price.
The volume resting on the best bid. If the value is equal to zero, then the size is unknown.
[
{
"symbol_id": "string",
"time_exchange": "2025-04-17T06:09:11.027Z",
"time_coinapi": "2025-04-17T06:09:11.027Z",
"ask_price": 0,
"ask_size": 0,
"bid_price": 0,
"bid_size": 0
}
]
[
{
"symbol_id": "BITSTAMP_SPOT_BTC_USD",
"time_exchange": "2013-09-28T22:40:50.0000000Z",
"time_coinapi": "2017-03-18T22:42:21.3763342Z",
"ask_price": 770,
"ask_size": 3252,
"bid_price": 760,
"bid_size": 124
},
{
"symbol_id": "BITSTAMP_SPOT_BTC_USD",
"time_exchange": "2013-09-28T22:40:50.0000000Z",
"time_coinapi": "2017-03-18T22:42:21.3763342Z",
"ask_price": 770,
"ask_size": 3252,
"bid_price": 760,
"bid_size": 124
}
]
- Schema
- Example (from schema)
- Example response
Schema
Array [
]
The symbol identifier.
The exchange time of the quote.
The CoinAPI time when the quote was received.
The best asking price.
The volume resting on the best ask. If the value is equal to zero, then the size is unknown.
The best bidding price.
The volume resting on the best bid. If the value is equal to zero, then the size is unknown.
[
{
"symbol_id": "string",
"time_exchange": "2025-04-17T06:09:11.028Z",
"time_coinapi": "2025-04-17T06:09:11.028Z",
"ask_price": 0,
"ask_size": 0,
"bid_price": 0,
"bid_size": 0
}
]
[
{
"symbol_id": "BITSTAMP_SPOT_BTC_USD",
"time_exchange": "2013-09-28T22:40:50.0000000Z",
"time_coinapi": "2017-03-18T22:42:21.3763342Z",
"ask_price": 770,
"ask_size": 3252,
"bid_price": 760,
"bid_size": 124
},
{
"symbol_id": "BITSTAMP_SPOT_BTC_USD",
"time_exchange": "2013-09-28T22:40:50.0000000Z",
"time_coinapi": "2017-03-18T22:42:21.3763342Z",
"ask_price": 770,
"ask_size": 3252,
"bid_price": 760,
"bid_size": 124
}
]