Twelve Data/GetExchangeRate

Twelve DataTwelve Data Forex API

GET/exchange_rate

Get an exchange rate

Returns the rate for a base/quote currency pair.

Query realtime and historical Forex market data, currency conversion, reference data, and technical indicators; callers connect directly with their own Twelve Data credential.

Request

operationId
GetExchangeRate
Server
https://api.twelvedata.com
Authentication
apiKey

Request parameters

symbol

querystringrequired

Forex currency pair in BASE/QUOTE form, for example EUR/USD.

EUR/USD

date

querystring

Date used for the query or conversion.

2025-01-02

format

queryFormatEnum

delimiter

querystring

delimiter field.

delimiter-sample

dp

queryintegerint64

dp field.

1

timezone

querystring

Timezone used for output timestamps.

UTC

Responses

200

GetExchangeRate_200_responseapplication/json

Request succeeded and returns this Endpoint's JSON payload.

Properties: ratesymboltimestamp

400

ApiBadRequestErrorResponseBodyapplication/json

The request parameters are invalid.

Properties: codemessagestatus

401

ApiUnauthorizedErrorResponseBodyapplication/json

The caller credential is missing or invalid.

Properties: codemessagestatus

403

ApiForbiddenErrorResponseBodyapplication/json

The caller plan or permission does not allow this request.

Properties: codemessagestatus

404

ApiNotFoundErrorResponseBodyapplication/json

The requested resource or data does not exist.

Properties: codemessagestatus

414

ApiParameterTooLongErrorResponseBodyapplication/json

The request parameters exceed the service length limit.

Properties: codemessagestatus

429

ApiTooManyRequestsErrorResponseBodyapplication/json

The caller exceeded a service rate or credit limit.

Properties: codemessagestatus

500

ApiInternalServerErrorResponseBodyapplication/json

The upstream service could not complete the request.

Properties: codemessagestatus

{
  "rate": 1.2345,
  "symbol": "EUR/USD",
  "timestamp": 1
}