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

# Time series cross

`GET /time_series/cross`

The Time Series Cross endpoint calculates and returns historical cross-rate data for exotic forex pairs, cryptocurrencies, or stocks (e.g., Apple Inc. price in Indian Rupees) on the fly. It provides metadata about the requested symbol and a time series array with Open, High, Low, and Close prices, sorted descending by time, enabling analysis of price history and market trends.

## Query parameters

- `base` string, required
- `base_type` string
- `base_exchange` string
- `base_mic_code` string
- `quote` string, required
- `quote_type` string
- `quote_exchange` string
- `quote_mic_code` string
- `interval` '1min' | '5min' | '15min' | '30min' | '45min' | '1h' | '2h' | '4h' | '8h' | '1day' | '1week' | '1month', required
- `outputsize` integer
- `format` 'JSON' | 'CSV'
- `delimiter` string
- `prepost` boolean
- `start_date` string
- `end_date` string
- `adjust` boolean
- `dp` integer
- `timezone` string

## Response `200`

- object
  - `meta` CrossMeta, required — Json object with request general information
    - `base_instrument` string, required — Base instrument symbol
    - `base_currency` string, required — Base currency
    - `base_exchange` string, required — Base exchange
    - `interval` string, required — Interval between two consecutive points in time series
    - `quote_instrument` string, required — Quote instrument symbol
    - `quote_currency` string, required — Quote currency
    - `quote_exchange` string, required — Quote exchange
  - `values` TimeSeriesCrossItem[], required — Array 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 the 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

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