---
title: "Historical data"
method: GET
path: "/v1/trades/{symbol_id}/history"
tags: ["Trades"]
---

# Historical data

`GET /v1/trades/{symbol_id}/history`

## Request

- Base URL: `https://rest.coinapi.io`
- URL: `https://rest.coinapi.io/v1/trades/{symbol_id}/history`
- Auth: one of:
  - API key in header `Authorization`
  - HTTP bearer
- TypeScript: <https://skmtc.dev/coinapi/apis/coinapi-market-data-rest-api/docs/v1/trades/:symbol_id/history/get.ts> (a function with typed inputs; its response is checked against the schema)

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'.
:::

## Path parameters

- `symbol_id` string, required

## Query parameters

- `date` string
- `time_start` string
- `time_end` string
- `limit` integer
- `include_id` boolean

## Response `200`

successful operation

- V1Trade[]
  - `symbol_id` string, nullable: The symbol identifier.
  - `time_exchange` string, date-time: The time of trade reported by the exchange.
  - `time_coinapi` string, date-time: The time when the trade was received by CoinAPI.
  - `uuid` string, uuid: The unique identifier for the trade.
  - `price` number, double: The price of the transaction.
  - `size` number, 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_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.
  - `user_taker` string, nullable: Wallet address of the taker (aggressive) side. Present only for L4 data sources.
  - `user_maker` string, nullable: Wallet address of the maker (passive) side. Present only for L4 data sources.

---

[API](https://skmtc.dev/coinapi/apis/coinapi-market-data-rest-api.md) - [All operations](https://skmtc.dev/coinapi/apis/coinapi-market-data-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/coinapi/apis/coinapi-market-data-rest-api/revisions/8e2d7b7d9f23?raw)