Currencies Endpoint

Returns all our supported currencies. The API supports 33 currencies — see the full currency list (opens new window).

Request Method: GET
Request URL: https://api.freecurrencyapi.com/v1/currencies

Request Parameters

Parameter	Type	Mandatory	Description
apikey	string	️	Your API Key
currencies	string		A list of comma-separated currency codes which you want to get (EUR,USD,CAD) By default all available currencies will be shown
as_html	boolean		1 returns the currency list as an HTML table instead of JSON

Example Request

curl "https://api.freecurrencyapi.com/v1/currencies?currencies=EUR,GBP" \
    -H "apikey: YOUR-APIKEY"

Sample Response

{
    "data": {
        "EUR": {
            "symbol": "€",
            "name": "Euro",
            "symbol_native": "€",
            "decimal_digits": 2,
            "rounding": 0,
            "code": "EUR",
            "name_plural": "Euros",
            "type": "fiat"
        },
        "GBP": {
            "symbol": "£",
            "name": "British Pound Sterling",
            "symbol_native": "£",
            "decimal_digits": 2,
            "rounding": 0,
            "code": "GBP",
            "name_plural": "British pounds sterling",
            "type": "fiat"
        }
    }
}

Because the example request filters to currencies=EUR,GBP, exactly those two entries are returned; omit the currencies parameter to receive all 33 supported currencies.

Response fields

Field	Description
code	The ISO 4217 code you pass as base_currency or in currencies
name	English name
name_plural	English plural, e.g. for "250 Euros"
symbol	Symbol as used in English, e.g. $ or CA$
symbol_native	Symbol as used in the currency's own country
decimal_digits	Number of decimals to show for amounts in this currency
rounding	Rounding increment for amounts, 0 for no special rounding
type	fiat for every currency freecurrencyapi supports

HTML table

With as_html=1 the endpoint returns an HTML <table> with the columns Code and Name instead of JSON, ready to embed in a page.

Errors and quota

An unknown code in currencies returns 422 with the parameter in errors. A successful call counts against your monthly quota like the rate endpoints; the X-Cost response header shows how many requests it used.