{"__v":10,"_id":"566b6f17bc5adc0d0096760c","category":{"__v":8,"_id":"566b431d03b4b20d00d02c3a","pages":["566b438f1766bf0d00e73981","566b51a3f46dc90d009de82a","566b57f068eba90d009cac72","566b6564461c970d0038bfd9","566b6f17bc5adc0d0096760c","566b7c8a03870a0d008ee7a2","566b81db30cdb417008d217b","56a48d9521d3d60d000341f4"],"project":"55312174c68f493900aebb3f","version":"55312174c68f493900aebb42","sync":{"url":"","isSync":false},"reference":true,"createdAt":"2015-12-11T21:41:49.917Z","from_sync":false,"order":1,"slug":"basic-requests","title":"API Endpoints"},"editedParams":true,"editedParams2":true,"project":"55312174c68f493900aebb3f","user":"5531215e29603d2300011341","version":{"__v":10,"_id":"55312174c68f493900aebb42","project":"55312174c68f493900aebb3f","createdAt":"2015-04-17T15:06:28.598Z","releaseDate":"2015-04-17T15:06:28.598Z","categories":["55312175c68f493900aebb43","566b431d03b4b20d00d02c3a","566b58f212bc0517005d3068","566b59110506f40d0034f148","566b7cc94d1a4d0d00801c00","566b82d130cdb417008d217d","566b855b4d1a4d0d00801c04","566b856f03870a0d008ee7a7","566c42d2f0a5dc0d009acbab","566c443d85dc790d0062c134"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"0.7.0","version":"0.7"},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2015-12-12T00:49:27.509Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"examples":{"codes":[{"code":"https://openexchangerates.org/api/currencies.json","language":"http","name":"HTTP"},{"code":"$.get('https://openexchangerates.org/api/currencies.json', function(data) {\n    console.log(data);\n});","language":"javascript","name":"jQuery"}]},"results":{"codes":[{"name":"","code":"\n{\n\t\"AED\": \"United Arab Emirates Dirham\",\n\t\"AFN\": \"Afghan Afghani\",\n\t\"ALL\": \"Albanian Lek\",\n  /* ... */\n}","language":"json","status":200}]},"settings":"","auth":"optional","params":[{"_id":"56a48153f24f960d0013e238","ref":"","in":"query","required":false,"desc":"","default":"1","type":"boolean","name":"prettyprint"},{"_id":"56a48153f24f960d0013e237","ref":"","in":"query","required":false,"desc":"","default":"0","type":"boolean","name":"show_alternative"}],"url":"/currencies.json"},"isReference":true,"order":2,"body":"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).\n[block:callout]\n{\n  \"type\": \"info\",\n  \"body\": \"Requests to currencies.json do not count towards your account usage limit, and App ID authentication is optional for this endpoint.\",\n  \"title\": \"\"\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Basic Code Samples\"\n}\n[/block]\n\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"$.get('https://openexchangerates.org/api/currencies.json', function(data) {\\n    console.log(\\\"Did you know? One unit of VND is known as a '\\\" + data.VND + \\\"'\\\");\\n});\",\n      \"language\": \"javascript\",\n      \"name\": \"jQuery\"\n    },\n    {\n      \"code\": \"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.\",\n      \"language\": \"text\",\n      \"name\": \"Others...\"\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Alternative, Experimental and Black-market Rates\"\n}\n[/block]\nYou can include the list of unofficial, black market and alternative digital currencies via the `show_alternative` or `only_alternative` parameters:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"https://openexchangerates.org/api/currencies.json\\n    ?show_alternative=1\",\n      \"language\": \"http\"\n    },\n    {\n      \"code\": \"$.get('https://openexchangerates.org/api/currencies.json?show_experimental=1', function(data) {\\n    console.log(data);\\n});\",\n      \"language\": \"javascript\",\n      \"name\": \"jQuery\"\n    }\n  ]\n}\n[/block]\nPlease note that alternative rates do not always use a three-letter code.\n\nYou can find more information on our [unofficial, black market and alternative digital currencies](doc:alternative-currencies) here.","excerpt":"Get a JSON list of all currency symbols available from the Open Exchange Rates API, along with their full names, for use in your integration. \n\nThis list will always mirror the currencies available in the latest rates (given as their 3-letter codes).","slug":"currencies-json","type":"get","title":"/currencies.json"}

get/currencies.json

Get a JSON list of all currency symbols available from the Open Exchange Rates API, along with their full names, for use in your integration. This list will always mirror the currencies available in the latest rates (given as their 3-letter codes).

Definition

{{ api_url }}{{ page_api_url }}

Parameters

Query Params

prettyprint:
boolean1
show_alternative:
boolean0

Examples


Result Format


Documentation

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). [block:callout] { "type": "info", "body": "Requests to currencies.json do not count towards your account usage limit, and App ID authentication is optional for this endpoint.", "title": "" } [/block] [block:api-header] { "type": "basic", "title": "Basic Code Samples" } [/block] [block:code] { "codes": [ { "code": "$.get('https://openexchangerates.org/api/currencies.json', function(data) {\n console.log(\"Did you know? One unit of VND is known as a '\" + data.VND + \"'\");\n});", "language": "javascript", "name": "jQuery" }, { "code": "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.", "language": "text", "name": "Others..." } ] } [/block] [block:api-header] { "type": "basic", "title": "Alternative, Experimental and Black-market Rates" } [/block] You can include the list of unofficial, black market and alternative digital currencies via the `show_alternative` or `only_alternative` parameters: [block:code] { "codes": [ { "code": "https://openexchangerates.org/api/currencies.json\n ?show_alternative=1", "language": "http" }, { "code": "$.get('https://openexchangerates.org/api/currencies.json?show_experimental=1', function(data) {\n console.log(data);\n});", "language": "javascript", "name": "jQuery" } ] } [/block] 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](doc:alternative-currencies) here.

User Information

Try It Out

get
{{ tryResults.results }}
Method{{ tryResults.method }}
Request Headers
{{ tryResults.requestHeaders }}
URL{{ tryResults.url }}
Request Data
{{ tryResults.data }}
Status
Response Headers
{{ tryResults.responseHeaders }}