---
title: "Timeseries periods"
method: GET
path: "/v1/exchangerate/history/periods"
tags: ["Exchange Rates"]
---

# Timeseries periods

`GET /v1/exchangerate/history/periods`

## Request

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

You can also obtain historical exchange rates of any asset pair, grouped into time periods.
Get full list of supported time periods available for requesting exchange rates historical timeseries data.
            
## Timeseries periods
Time unit |	Period identifiers
--- | ---
Second | 1SEC, 2SEC, 3SEC, 4SEC, 5SEC, 6SEC, 10SEC, 15SEC, 20SEC, 30SEC
Minute | 1MIN, 2MIN, 3MIN, 4MIN, 5MIN, 6MIN, 10MIN, 15MIN, 20MIN, 30MIN
Hour | 1HRS, 2HRS, 3HRS, 4HRS, 6HRS, 8HRS, 12HRS
Day | 1DAY, 2DAY, 3DAY, 5DAY, 7DAY, 10DAY

## Response `200`

successful operation

- V1TimeseriesPeriod[]
  - `period_id` string, nullable: Gets or sets the period ID.
  - `length_seconds` integer: Gets or sets the length of the period in seconds.
  - `length_months` integer: Gets or sets the length of the period in months.
  - `unit_count` integer, nullable: Gets or sets the unit count.
  - `unit_name` string, nullable: Gets or sets the unit name.
  - `display_name` string, nullable: Gets or sets the display name of the timeseries period.

---

[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)