Historical data
GET/v1/trades/:symbol_id/history
Get history transactions from specific symbol, returned in time ascending order.
The 'time_start' and 'time_end' parameters are deprecated and will be removed in future versions. Please use the 'date' parameter instead for querying data for a specific day.
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 (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)
Information that additional exchange trade identifier should be included in the id_trade
parameter of the trade if exchange providing identifiers.
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 time of trade reported by the exchange.
The time when the trade was received by CoinAPI.
The unique identifier for the trade.
The price of the transaction.
The base asset amount traded in the transaction.
The aggressor side of the transaction (BUY/SELL/BUY_ESTIMATED/SELL_ESTIMATED/UNKNOWN).
The trade identifier.
The order maker identifier.
The order taker identifier.
[
{
"symbol_id": "string",
"time_exchange": "2024-11-29T10:04:03.797Z",
"time_coinapi": "2024-11-29T10:04:03.797Z",
"uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"price": 0,
"size": 0,
"taker_side": "string",
"id_trade": "string",
"id_order_maker": "string",
"id_order_taker": "string"
}
]
[
{
"symbol_id": "BITSTAMP_SPOT_BTC_USD",
"time_exchange": "2013-09-28T22:40:50.0000000Z",
"time_coinapi": "2017-03-18T22:42:21.3763342Z",
"uuid": "770c7a3b-7258-4441-8182-83740f3e2457",
"price": 770,
"size": 0.05,
"taker_side": "BUY"
},
{
"symbol_id": "BITSTAMP_SPOT_BTC_USD",
"time_exchange": "2013-09-28T23:12:59.0000000Z",
"time_coinapi": "2017-03-18T22:42:21.3763342Z",
"uuid": "1ea8adc5-6459-47ca-adbf-0c3f8c729bb2",
"price": 770,
"size": 0.05,
"taker_side": "SELL"
}
]
- Schema
- Example (from schema)
- Example response
Schema
Array [
]
The symbol identifier.
The time of trade reported by the exchange.
The time when the trade was received by CoinAPI.
The unique identifier for the trade.
The price of the transaction.
The base asset amount traded in the transaction.
The aggressor side of the transaction (BUY/SELL/BUY_ESTIMATED/SELL_ESTIMATED/UNKNOWN).
The trade identifier.
The order maker identifier.
The order taker identifier.
[
{
"symbol_id": "string",
"time_exchange": "2024-11-29T10:04:03.798Z",
"time_coinapi": "2024-11-29T10:04:03.798Z",
"uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"price": 0,
"size": 0,
"taker_side": "string",
"id_trade": "string",
"id_order_maker": "string",
"id_order_taker": "string"
}
]
[
{
"symbol_id": "BITSTAMP_SPOT_BTC_USD",
"time_exchange": "2013-09-28T22:40:50.0000000Z",
"time_coinapi": "2017-03-18T22:42:21.3763342Z",
"uuid": "770c7a3b-7258-4441-8182-83740f3e2457",
"price": 770,
"size": 0.05,
"taker_side": "BUY"
},
{
"symbol_id": "BITSTAMP_SPOT_BTC_USD",
"time_exchange": "2013-09-28T23:12:59.0000000Z",
"time_coinapi": "2017-03-18T22:42:21.3763342Z",
"uuid": "1ea8adc5-6459-47ca-adbf-0c3f8c729bb2",
"price": 770,
"size": 0.05,
"taker_side": "SELL"
}
]
- Schema
- Example (from schema)
- Example response
Schema
Array [
]
The symbol identifier.
The time of trade reported by the exchange.
The time when the trade was received by CoinAPI.
The unique identifier for the trade.
The price of the transaction.
The base asset amount traded in the transaction.
The aggressor side of the transaction (BUY/SELL/BUY_ESTIMATED/SELL_ESTIMATED/UNKNOWN).
The trade identifier.
The order maker identifier.
The order taker identifier.
[
{
"symbol_id": "string",
"time_exchange": "2024-11-29T10:04:03.798Z",
"time_coinapi": "2024-11-29T10:04:03.798Z",
"uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"price": 0,
"size": 0,
"taker_side": "string",
"id_trade": "string",
"id_order_maker": "string",
"id_order_taker": "string"
}
]
[
{
"symbol_id": "BITSTAMP_SPOT_BTC_USD",
"time_exchange": "2013-09-28T22:40:50.0000000Z",
"time_coinapi": "2017-03-18T22:42:21.3763342Z",
"uuid": "770c7a3b-7258-4441-8182-83740f3e2457",
"price": 770,
"size": 0.05,
"taker_side": "BUY"
},
{
"symbol_id": "BITSTAMP_SPOT_BTC_USD",
"time_exchange": "2013-09-28T23:12:59.0000000Z",
"time_coinapi": "2017-03-18T22:42:21.3763342Z",
"uuid": "1ea8adc5-6459-47ca-adbf-0c3f8c729bb2",
"price": 770,
"size": 0.05,
"taker_side": "SELL"
}
]
- Schema
- Example (from schema)
- Example response
Schema
Array [
]
The symbol identifier.
The time of trade reported by the exchange.
The time when the trade was received by CoinAPI.
The unique identifier for the trade.
The price of the transaction.
The base asset amount traded in the transaction.
The aggressor side of the transaction (BUY/SELL/BUY_ESTIMATED/SELL_ESTIMATED/UNKNOWN).
The trade identifier.
The order maker identifier.
The order taker identifier.
[
{
"symbol_id": "string",
"time_exchange": "2024-11-29T10:04:03.799Z",
"time_coinapi": "2024-11-29T10:04:03.799Z",
"uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"price": 0,
"size": 0,
"taker_side": "string",
"id_trade": "string",
"id_order_maker": "string",
"id_order_taker": "string"
}
]
[
{
"symbol_id": "BITSTAMP_SPOT_BTC_USD",
"time_exchange": "2013-09-28T22:40:50.0000000Z",
"time_coinapi": "2017-03-18T22:42:21.3763342Z",
"uuid": "770c7a3b-7258-4441-8182-83740f3e2457",
"price": 770,
"size": 0.05,
"taker_side": "BUY"
},
{
"symbol_id": "BITSTAMP_SPOT_BTC_USD",
"time_exchange": "2013-09-28T23:12:59.0000000Z",
"time_coinapi": "2017-03-18T22:42:21.3763342Z",
"uuid": "1ea8adc5-6459-47ca-adbf-0c3f8c729bb2",
"price": 770,
"size": 0.05,
"taker_side": "SELL"
}
]