Skip to main content

List All Currencies

Fetch a complete list of all available currencies supported by the OpenFXRates API.

Endpoint

GET /currencies

Parameters

No parameters required.

Request Example

curl -X GET "https://api.openfxrates.com/currencies" \
-H "X-API-Key: your-api-key-here"

Response Schema

{
"status": "SUCCESS",
"data": {
"currencies": {
"USD": "United States Dollar",
"EUR": "Euro",
"GBP": "British Pound Sterling",
"JPY": "Japanese Yen",
"CHF": "Swiss Franc"
},
"timestamp": "2026-01-22T11:37:01.941Z",
"meta_data": {
"monthly_requests": 100000,
"remaining_requests": 99993,
"reset_time": null
}
}
}

Response Fields

FieldTypeDescription
statusstringRequest status (SUCCESS or FAILED)
dataobjectResponse data container
currenciesobjectCurrency codes as keys with currency names as values
timestampstringISO 8601 timestamp of the response
meta_dataobjectAPI usage information
meta_data.monthly_requestsnumberTotal monthly request limit
meta_data.remaining_requestsnumberRemaining requests for the month
meta_data.reset_timestring/nullWhen the limit resets

Status Codes

StatusDescription
200Success - Currency list returned
401Unauthorized - Invalid or missing API key
429Too Many Requests - Rate limit exceeded

Error Response

{
"status": "FAILED",
"message": "Unauthorized: No API key provided"
}

Example Response

{
"status": "SUCCESS",
"data": {
"currencies": {
"AED": "United Arab Emirates Dirham",
"AUD": "Australian Dollar",
"CAD": "Canadian Dollar",
"CHF": "Swiss Franc",
"EUR": "Euro",
"GBP": "British Pound Sterling",
"JPY": "Japanese Yen",
"USD": "United States Dollar"
},
"timestamp": "2026-01-22T11:37:01.941Z",
"meta_data": {
"monthly_requests": 100000,
"remaining_requests": 99993,
"reset_time": null
}
}
}

Total Currencies

OpenFXRates supports 160+ currencies including:

  • Major currencies (USD, EUR, GBP, JPY, CHF, CAD, AUD, NZD)
  • Asian currencies (CNY, INR, KRW, SGD, HKD, THB, IDR, MYR, PHP)
  • European currencies (SEK, NOK, DKK, CZK, HUF, PLN, RON, HRK)
  • Middle Eastern currencies (AED, SAR, QAR, KWD, BHD, OMR, JOD)
  • African currencies (ZAR, EGP, NGN, KES, MAD)
  • Crypto-backed currencies
  • And many more...

Use Cases

  • Validation - Check if a currency is supported before making requests
  • UI Building - Populate currency dropdowns and selectors
  • App Configuration - Display currency options to users
  • Testing - Discover available currencies for testing

Caching Recommendation

This endpoint returns static data that rarely changes. Cache the results for:

  • 24 hours for most applications
  • 1 week for less frequently updated apps

Performance

  • Response Size: ~50-80 KB depending on symbol inclusion
  • Caching: Strongly recommended to minimize API calls
  • Freshness: Updates when new currencies are added (rare)

Common Currency Codes

CodeCurrencySymbol
USDUS Dollar$
EUREuro
GBPBritish Pound£
JPYJapanese Yen¥
CHFSwiss FrancCHF
CADCanadian DollarC$
AUDAustralian DollarA$
NZDNew Zealand DollarNZ$
CNYChinese Yuan¥
INRIndian Rupee

See Also