Currencies Endpoint

Returns a list of all featured currencies of currencyapi.

GET/v3/currencies

Supported Currencies

The endpoint returns a list of all supported currencies that are available through our other endpoints.

Optional attributes

Name
currencies
Type
string
Description
A list of comma separated currency codes which you want to get (EUR,USD,CAD) By default all available currencies will be shown
Name
type
Type
string
Description
The type of currency you want to get (fiat, metal or crypto) By default all types will be shown
Name
as_html
Type
boolean
Description
When set to true, the endpoint returns an HTML table of currency codes and names instead of a JSON payload Default: false

Response Structure

Our /currencies endpoint offers the following information for every currency, keyed by its currency code inside the data object:

Name
symbol
Type
string
Description
The international symbol of the currency (e.g. $)
Name
name
Type
string
Description
The English name of the currency
Name
symbol_native
Type
string
Description
The symbol used natively where the currency is used (e.g. د.إ)
Name
decimal_digits
Type
integer
Description
The number of decimal digits commonly used with this currency
Name
rounding
Type
integer
Description
The rounding applied to amounts in this currency
Name
code
Type
string
Description
The currency code (ISO 4217 for fiat and metals, common tickers for crypto)
Name
name_plural
Type
string
Description
The English plural name of the currency
Name
type
Type
string
Description
The type of the currency: fiat, metal or crypto
Name
countries
Type
array
Description
Two-letter codes of the countries in which the currency is used

Request

GET

/v3/currencies

curl -G https://api.currencyapi.com/v3/currencies \
    -H "apikey: YOUR-API-KEY"

Full Response

{
    "data": {
        "AED": {
            "symbol": "AED",
            "name": "United Arab Emirates Dirham",
            "symbol_native": "د.إ",
            "decimal_digits": 2,
            "rounding": 0,
            "code": "AED",
            "name_plural": "UAE dirhams",
            "type": "fiat",
            "countries": [
                "AE"
            ]
        },
        "AFN": {
            "symbol": "Af",
            "name": "Afghan Afghani",
            "symbol_native": "؋",
            "decimal_digits": 0,
            "rounding": 0,
            "code": "AFN",
            "name_plural": "Afghan Afghanis",
            "type": "fiat",
            "countries": [
                "AF"
            ]
        },
        "...": {}
    }
}