---
title: "Time series"
method: GET
path: "/time_series"
tags: ["market_data"]
---

# Time series

`GET /time_series`

The time series endpoint provides detailed historical data for a specified financial instrument. It returns two main components: metadata, which includes essential information about the instrument, and a time series dataset. The time series consists of chronological entries with Open, High, Low, and Close prices, and for applicable instruments, it also includes trading volume. This endpoint is ideal for retrieving comprehensive historical price data for analysis or visualization purposes.

## Query parameters

- `symbol` string
- `isin` string
- `figi` string
- `cusip` string
- `interval` '1min' | '5min' | '15min' | '30min' | '45min' | '1h' | '2h' | '4h' | '8h' | '1day' | '1week' | '1month', required
- `outputsize` integer
- `exchange` string
- `mic_code` string
- `country` string
- `type` 'American Depositary Receipt' | 'Bond' | 'Bond Fund' | 'Closed-end Fund' | 'Common Stock' | 'Depositary Receipt' | 'Digital Currency' | 'ETF' | 'Exchange-Traded Note' | 'Global Depositary Receipt' | 'Limited Partnership' | 'Mutual Fund' | 'Physical Currency' | 'Preferred Stock' | 'REIT' | 'Right' | 'Structured Product' | 'Trust' | 'Unit' | 'Warrant'
- `timezone` string
- `start_date` string
- `end_date` string
- `date` string
- `order` 'asc' | 'desc'
- `prepost` boolean
- `format` 'JSON' | 'CSV'
- `delimiter` string
- `dp` integer
- `previous_close` boolean
- `adjust` 'all' | 'splits' | 'dividends' | 'none'

## Response `200`

- object
  - `meta` object, required — Json object with request general information
    - `symbol` string, required — The ticker symbol of an instrument for which data was requested.
    - `interval` string, required — The time gap between consecutive data points.
    - `currency` string — The currency of a traded instrument.
    - `exchange_timezone` string — The timezone of the exchange where the instrument is traded.
    - `exchange` string — The exchange name where the instrument is traded.
    - `mic_code` string — The Market Identifier Code (MIC) of the exchange where the instrument is traded.
    - `type` string, required — The asset class to which the instrument belongs.
  - `values` TimeSeriesItem[], required — List of time series data points
    - `datetime` string, required — Datetime at local exchange time referring to when the bar with specified interval was opened.
    - `open` string, required — Price at the opening of current bar
    - `high` string, required — Highest price which occurred during the current bar.
    - `low` string, required — Lowest price which occurred during the current bar.
    - `close` string, required — Close price at the end of the bar.
    - `volume` string — Trading volume which occurred during the current bar
  - `status` string, required — Response status

## Other responses

- `400`
- `401`
- `403`
- `404`
- `414`
- `429`
- `500`

---

[API](https://skmtc.net/twelvedata/apis/twelve-data-api.md) · [All operations](https://skmtc.net/twelvedata/apis/twelve-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/twelvedata/twelve-data-api/revisions/c4a12725cdb5/schema)