Twelve Data/GetForexPairs

Twelve DataTwelve Data Forex API

GET/forex_pairs

List Forex pairs

Lists available Forex pairs and supports pair or base/quote filtering.

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
GetForexPairs
Server
https://api.twelvedata.com
Authentication
apiKey

Request parameters

symbol

querystringrequired

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

EUR/USD

currency_base

querystring

Base-currency code.

EUR

currency_quote

querystring

Quote-currency code.

USD

format

queryFormatEnum

delimiter

querystring

delimiter field.

delimiter-sample

page

queryintegerint64

page field.

1

outputsize

queryintegerint64

Number of data points to return.

2

Responses

200

GetForexPairs_200_responseapplication/json

Request succeeded and returns this Endpoint's JSON payload.

Properties: countdatastatus

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

{
  "count": 1,
  "data": {
    "currency_base": "EUR",
    "currency_group": "currency_group-sample",
    "currency_quote": "USD",
    "symbol": "EUR/USD"
  },
  "status": "ok"
}