Historical data
GET /v1/trades/:symbol_id/history
Get history transactions from specific symbol, returned in time ascending order.
Path Parameters
- symbol_id string required
Symbol identifier for requested timeseries (from the Metadata -> Symbols)
Query Parameters
- time_start string
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 result elements count 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_id boolean
Information that additional exchange trade identifier should be included in the
id_trade
parameter of the trade if exchange providing identifiers.
- 200
successful operation
- text/plain
- application/json
- text/json
- application/x-msgpack
- Schema
- Example (from schema)
- Example response
Schema
- Array [
- symbol_id string nullable
The symbol identifier.
- time_exchange date-time
The time of trade reported by the exchange.
- time_coinapi date-time
The time when the trade was received by CoinAPI.
- uuid uuid
The unique identifier for the trade.
- price double
The price of the transaction.
- size double
The base asset amount traded in the transaction.
- taker_side string nullable
The aggressor side of the transaction (BUY/SELL/BUY_ESTIMATED/SELL_ESTIMATED/UNKNOWN).
- id_trade string nullable
The trade identifier.
- id_order_maker string nullable
The order maker identifier.
- id_order_taker string nullable
The order taker identifier.
- ]
[
{
"symbol_id": "string",
"time_exchange": "2024-04-29T10:40:58.244Z",
"time_coinapi": "2024-04-29T10:40:58.244Z",
"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 [
- symbol_id string nullable
The symbol identifier.
- time_exchange date-time
The time of trade reported by the exchange.
- time_coinapi date-time
The time when the trade was received by CoinAPI.
- uuid uuid
The unique identifier for the trade.
- price double
The price of the transaction.
- size double
The base asset amount traded in the transaction.
- taker_side string nullable
The aggressor side of the transaction (BUY/SELL/BUY_ESTIMATED/SELL_ESTIMATED/UNKNOWN).
- id_trade string nullable
The trade identifier.
- id_order_maker string nullable
The order maker identifier.
- id_order_taker string nullable
The order taker identifier.
- ]
[
{
"symbol_id": "string",
"time_exchange": "2024-04-29T10:40:58.245Z",
"time_coinapi": "2024-04-29T10:40:58.245Z",
"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 [
- symbol_id string nullable
The symbol identifier.
- time_exchange date-time
The time of trade reported by the exchange.
- time_coinapi date-time
The time when the trade was received by CoinAPI.
- uuid uuid
The unique identifier for the trade.
- price double
The price of the transaction.
- size double
The base asset amount traded in the transaction.
- taker_side string nullable
The aggressor side of the transaction (BUY/SELL/BUY_ESTIMATED/SELL_ESTIMATED/UNKNOWN).
- id_trade string nullable
The trade identifier.
- id_order_maker string nullable
The order maker identifier.
- id_order_taker string nullable
The order taker identifier.
- ]
[
{
"symbol_id": "string",
"time_exchange": "2024-04-29T10:40:58.245Z",
"time_coinapi": "2024-04-29T10:40:58.245Z",
"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 [
- symbol_id string nullable
The symbol identifier.
- time_exchange date-time
The time of trade reported by the exchange.
- time_coinapi date-time
The time when the trade was received by CoinAPI.
- uuid uuid
The unique identifier for the trade.
- price double
The price of the transaction.
- size double
The base asset amount traded in the transaction.
- taker_side string nullable
The aggressor side of the transaction (BUY/SELL/BUY_ESTIMATED/SELL_ESTIMATED/UNKNOWN).
- id_trade string nullable
The trade identifier.
- id_order_maker string nullable
The order maker identifier.
- id_order_taker string nullable
The order taker identifier.
- ]
[
{
"symbol_id": "string",
"time_exchange": "2024-04-29T10:40:58.245Z",
"time_coinapi": "2024-04-29T10:40:58.245Z",
"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"
}
]