v3

latestOpenAPI 3.0.4MIT License2026-08-055029423.0 KB
Trades

Historical data

Get history transactions from specific symbol, returned in time ascending order.

This endpoint supports hourly granularity for APITP data with automatic fallback to daily data for older records. Timestamps are normalized to hour boundaries, and data is fetched per hour with precise filtering to your exact time range.

:::tip For querying a full day of data, use the 'date' parameter. For specific time ranges (including cross-day or multi-hour queries), use 'time_start' and 'time_end'. :::

get/v1/trades/{symbol_id}/history

Path parameters

symbol_idstring required

Symbol identifier for requested timeseries (from the Metadata -> Symbols)

Query parameters

datestring

Date in ISO 8601, returned data is for the whole given day (required if 'time_start' is not provided)

time_startstring

Starting time in ISO 8601 (supports hourly precision, e.g., 2026-01-16T11:00:00Z)

time_endstring

Timeseries ending time in ISO 8601 (optional, supports cross-day queries)

limitinteger

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)

include_idboolean

Information that additional exchange trade identifier should be included in the id_trade parameter of the trade if exchange providing identifiers.

Response

successful operation

symbol_idstring nullable

The symbol identifier.

time_exchangestring date-time

The time of trade reported by the exchange.

time_coinapistring date-time

The time when the trade was received by CoinAPI.

uuidstring uuid

The unique identifier for the trade.

pricenumber double

The price of the transaction.

sizenumber double

The base asset amount traded in the transaction. If the value is zero, it indicates that the transaction price is just marking a data point, such as in the index time series.

taker_sidestring nullable

The aggressor side of the transaction (BUY/SELL/BUY_ESTIMATED/SELL_ESTIMATED/UNKNOWN).

id_tradestring nullable

The trade identifier.

id_order_makerstring nullable

The order maker identifier.

id_order_takerstring nullable

The order taker identifier.

user_takerstring nullable

Wallet address of the taker (aggressive) side. Present only for L4 data sources.

user_makerstring nullable

Wallet address of the maker (passive) side. Present only for L4 data sources.