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

**API credits cost:** `5` per symbol

## Parameters

- `base` (string, required)
  Base currency symbol


- `base_type` (string, optional)
  Base instrument type according to the `/instrument_type` endpoint


- `base_exchange` (string, optional)
  Base exchange


- `base_mic_code` (string, optional)
  Base MIC code


- `quote` (string, required)
  Quote currency symbol


- `quote_type` (string, optional)
  Quote instrument type according to the `/instrument_type` endpoint


- `quote_exchange` (string, optional)
  Quote exchange


- `quote_mic_code` (string, optional)
  Quote MIC code


- `interval` (string, required)
  Interval between two consecutive points in time series


- `outputsize` (integer, optional)
  Number of data points to retrieve. Supports values in the range from `1` to `5000`. Default `30` when no date parameters are set, otherwise set to maximum


- `format` (string, optional)
  Format of the response data


- `delimiter` (string, optional)
  Delimiter used in CSV file


- `prepost` (boolean, optional)
  Only for `Pro` and above plans.
Available at the `1min`, `5min`, `15min`, and `30min` intervals for US equities.
Open, high, low, close values are supplied without volume.


- `start_date` (string, optional)
  Start date for the time series data


- `end_date` (string, optional)
  End date for the time series data


- `adjust` (boolean, optional)
  Specifies if there should be an adjustment


- `dp` (integer, optional)
  Specifies the number of decimal places for floating values.
Should be in range [0, 11] inclusive.


- `timezone` (string, optional)
  Timezone at which output datetime will be displayed. Supports:

1. Exchange for local exchange time
2. UTC for datetime at universal UTC standard
3. Timezone name according to the IANA Time Zone Database. E.g. America/New_York, Asia/Singapore. Full list of timezones can be found here.

Take note that the IANA Timezone name is case-sensitive



## Response

- `meta` (object)
  Json object with request general information
  - `base_instrument` (string)
    Base instrument symbol
  - `base_currency` (string)
    Base currency
  - `base_exchange` (string)
    Base exchange
  - `interval` (string)
    Interval between two consecutive points in time series
  - `quote_instrument` (string)
    Quote instrument symbol
  - `quote_currency` (string)
    Quote currency
  - `quote_exchange` (string)
    Quote exchange

- `values` (array of object)
  Array of time series data points
  - `datetime` (string)
    Datetime at local exchange time referring to when the bar with specified interval was opened
  - `open` (string)
    Price at the opening of the current bar
  - `high` (string)
    Highest price which occurred during the current bar
  - `low` (string)
    Lowest price which occurred during the current bar
  - `close` (string)
    Close price at the end of the bar


## Example Request

```bash
curl "https://api.twelvedata.com/time_series/cross?base=JPY&quote=BTC&interval=1min&apikey=demo"
```

## Example Response

```json
{
    "meta": {
        "base_instrument": "JPY/USD",
        "base_currency": "",
        "base_exchange": "PHYSICAL CURRENCY",
        "interval": "1min",
        "quote_instrument": "BTC/USD",
        "quote_currency": "",
        "quote_exchange": "Coinbase Pro"
    },
    "values": [
        {
            "datetime": "2025-02-28 14:30:00",
            "open": "0.0000081115665",
            "high": "0.0000081273069",
            "low": "0.0000081088287",
            "close": "0.0000081268066"
        }
    ]
}
```