Skip to main content
GET
Currency symbols

Getting started

Base URL

Validation endpoint

The symbols endpoint represents the most straightforward API call in the Exchange Rates service, requiring only your API key to retrieve the complete list of available currency symbols.
This successful request returns all available currency symbols with their corresponding descriptions:

Request parameters

String
required
Your unique API key. Note that each user has unique API keys for each of Cleariflow APIs, so your Exchange Rates API key will not work for your IP Geolocation API, for example.

Response parameters

The API response is returned in a universal and lightweight JSON format.
Object
A JSON Object containing all available currency symbols as keys with their full descriptions as values. This includes traditional fiat currencies (USD, EUR, GBP, etc.) and popular cryptocurrencies (BTC, ETH, etc.).
Integer
The Unix timestamp of when the currency symbols were last updated from the data source.

Use cases

Getting all available currencies

The symbols endpoint is perfect for:
  • Dynamic UI generation: Populate dropdown menus or currency selectors in your application
  • Currency validation: Check if a currency code is supported before making exchange rate requests
  • Currency discovery: Explore all available currencies in the Exchange Rates API
  • Application setup: Initialize your application with the complete list of supported currencies

Example use case: Currency selector

Supported currencies

The Exchange Rates API supports 80+ currencies, including:
  • Major fiat currencies: USD, EUR, GBP, JPY, AUD, CAD, CHF, CNY
  • European currencies: SEK, NOK, DKK, PLN, CZK, HUF, RON, BGN, HRK, ISK
  • Asian currencies: KRW, SGD, HKD, TWD, MYR, PHP, THB, IDR, INR, ILS
  • Americas currencies: BRL, MXN, ARS
  • African currencies: ZAR, MAD, DZD
  • Cryptocurrencies: BTC, ETH, BNB, DOGE, XRP, BCH, LTC
All currency codes follow the ISO 4217 standard for international compatibility.