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.
2 credits/call
Pricing
2 credits/call
| Condition | Charge |
|---|---|
| Each call | 2 credits/call |
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
dp | integer | No | Specifies the number of decimal places for floating values. Should be in range [0, 11] inclusive. | 5 |
base | string | Yes | Base currency symbol | — |
quote | string | Yes | Quote currency symbol | — |
adjust | boolean | No | Specifies if there should be an adjustment | true |
format | enum (JSON | CSV) | No | Format of the response data | JSON |
end_date | string | No | End date for the time series data | — |
interval | enum (1min | 5min | 15min | 30min | 45min | 1h | 2h | 4h | 8h | 1day | 1week | 1month) | Yes | Interval between two consecutive points in time series | — |
timezone | string | No | Timezone 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_type | string | No | Base instrument type according to the `/instrument_type` endpoint | — |
delimiter | string | No | Delimiter used in CSV file | ; |
outputsize | integer | No | 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 | — |
quote_type | string | No | Quote instrument type according to the `/instrument_type` endpoint | — |
start_date | string | No | Start date for the time series data | — |
base_exchange | string | No | Base exchange | — |
base_mic_code | string | No | Base MIC code | — |
quote_exchange | string | No | Quote exchange | — |
quote_mic_code | string | No | Quote MIC code | — |
Invocation example
Copy the request and explore its response example.
POST
/agent-api/v1/tool/executeX-Api-KeyRequest 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
{
"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.

