Twelve Data Get Time Series Cross

2 credits/call
ae_twelvedata_get_time_series_cross

Get Twelve Data historical OHLC price data for a cross rate between two assets, such as a stock priced in another currency or a crypto pair.

Crypto
2 credits/call

Pricing

2 credits/call
ConditionCharge
Each call2 credits/call

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
dpintegerNoSpecifies the number of decimal places for floating values. Should be in range [0, 11] inclusive.5
basestringYesBase currency symbol—
quotestringYesQuote currency symbol—
adjustbooleanNoSpecifies if there should be an adjustmenttrue
formatenum (JSON | CSV)NoFormat of the response dataJSON
end_datestringNoEnd date for the time series data—
intervalenum (1min | 5min | 15min | 30min | 45min | 1h | 2h | 4h | 8h | 1day | 1week | 1month)YesInterval between two consecutive points in time series—
timezonestringNoTimezone at which output datetime will be displayed. Supports: <ul> <li>1. <code>Exchange</code> for local exchange time</li> <li>2. <code>UTC</code> for datetime at universal UTC standard</li> <li>3. Timezone name according to the IANA Time Zone Database. E.g. <code>America/New_York</code>, <code>Asia/Singapore</code>. Full list of timezones can be found <a href="https://en.wikipedia.org/wiki/List_of_tz_database_time_zones" target="blank">here</a>.</li> </ul> <i>Take note that the IANA Timezone name is case-sensitive</i>—
base_typestringNoBase instrument type according to the `/instrument_type` endpoint—
delimiterstringNoDelimiter used in CSV file;
outputsizeintegerNoNumber 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—
quote_typestringNoQuote instrument type according to the `/instrument_type` endpoint—
start_datestringNoStart date for the time series data—
base_exchangestringNoBase exchange—
base_mic_codestringNoBase MIC code—
quote_exchangestringNoQuote exchange—
quote_mic_codestringNoQuote MIC code—

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key
Request coderequest.sh
curl --request POST \
  --url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_twelvedata_get_time_series_cross' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "base": "SOL",
    "base_type": "Digital Currency",
    "dp": 3,
    "format": "JSON",
    "interval": "4h",
    "outputsize": 6,
    "quote": "USDT",
    "quote_type": "Digital Currency",
    "timezone": "UTC"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "meta": {
    "base_currency": "",
    "base_exchange": "Binance",
    "base_instrument": "SOL/USD",
    "interval": "4h",
    "quote_currency": "",
    "quote_exchange": "Kraken"
  },
  "values": [
    {
      "close": "84.776",
      "datetime": "2026-11-11 20:00:00",
      "high": "85.259",
      "low": "84.609",
      "open": "84.940"
    }
  ]
}

This example shows part of the response. Copied content is valid JSON.