The standard response is a JSON object (e.g. a hash/dictionary/associative array), where each key:value pair represents a currency’s symbol and unit display name (singular and Capitalised).

📘
Requests to currencies.json do not count towards your account usage limit, and App ID authentication is optional for this endpoint.

Basic Code Samples

$.get('https://openexchangerates.org/api/currencies.json', function(data) {
    console.log("Did you know? One unit of VND is known as a '" + data.VND + "'");
});

More code samples are on their way! Please get in touch if you'd like to submit a new/improved code sample in your languague or framework.

Alternative, Experimental and Black-market Rates

You can include the list of unofficial, black market and alternative digital currencies via the show_alternative or only_alternative parameters:

https://openexchangerates.org/api/currencies.json
    ?show_alternative=1

$.get('https://openexchangerates.org/api/currencies.json?show_experimental=1', function(data) {
    console.log(data);
});

Please note that alternative rates do not always use a three-letter code.

You can find more information on our unofficial, black market and alternative digital currencies here.