Skip to main content
GET
Supported Currencies

Overview

The symbols endpoint returns detailed information about all currencies supported by the Exchange Rates API. This includes currency names, symbols, country information, and notes about special currencies.
This endpoint is public and doesn’t require authentication. It’s perfect for building currency selection dropdowns and validation logic.

Request

Response

boolean
required
Always true for successful responses
object
required
Object containing currency information keyed by ISO 4217 currency code
string
required
Full name of the currency
string
required
Currency symbol or abbreviation used for display
string
required
Country or region where the currency is used
number
required
Total number of supported currencies
string
required
Base currency for all exchange rates (always “AUD”)
string
General information about how rates are quoted

Supported Currencies

Major Global Currencies

Asia-Pacific Region

¹ IDR and VND Precision: Indonesian Rupiah and Vietnamese Dong are provided as whole numbers (no decimal places) by the Reserve Bank of Australia source data.

Special Currencies

TWI Conversion Restriction: The Trade-Weighted Index (TWI) is included in rate listings but cannot be used in conversion operations (/convert endpoint). Using TWI as from or to parameter will return a 400 error.

Building Currency Dropdowns

Use the symbols endpoint to populate currency selection interfaces:

Validation Logic

Use the symbols data for input validation:

Response Headers

The symbols endpoint is cached for 24 hours (max-age=86400) since supported currencies rarely change. This helps improve performance and reduces unnecessary requests.

Common Use Cases

1. Currency Selection Interface

Build dropdown menus or search interfaces for currency selection.

2. Input Validation

Validate user-provided currency codes before making API requests.

3. Display Formatting

Use currency symbols and names for user-friendly display of rates and amounts.

4. Feature Detection

Check if specific currencies are supported before implementing features.

5. Conversion Compatibility

Determine which currencies can be used with the /convert endpoint (excluding TWI).

Error Responses

The symbols endpoint is highly reliable, but may occasionally return errors:
In such cases, implement fallback logic with a hardcoded list of major currencies to maintain functionality.

Response

200 - application/json

List of supported currencies

success
boolean
required
Example:

true

symbols
object
required
count
integer
required

Number of supported currencies

base
string
required
Example:

"AUD"

note
string
required