{"metadata":{"image":[],"title":"","description":""},"api":{"url":"/currencies.json","auth":"optional","examples":{"codes":[{"language":"http","code":"https://openexchangerates.org/api/currencies.json","name":"HTTP"},{"name":"jQuery","language":"javascript","code":"$.get('https://openexchangerates.org/api/currencies.json', function(data) {\n console.log(data);\n});"}]},"method":"get","params":[{"name":"prettyprint","type":"boolean","default":"1","desc":"","required":false,"in":"query","ref":"","_id":"56a48153f24f960d0013e238"},{"name":"show_alternative","type":"boolean","default":"0","desc":"Include alternative currencies.","required":false,"in":"query","ref":"","_id":"56a48153f24f960d0013e237"},{"name":"show_inactive","type":"boolean","default":"0","desc":"Include historical/inactive currencies","required":false,"in":"query","ref":"","_id":"5a46aa2adf69ff001ce4fef8"}],"results":{"codes":[{"status":200,"language":"json","code":"\n{\n\t\"AED\": \"United Arab Emirates Dirham\",\n\t\"AFN\": \"Afghan Afghani\",\n\t\"ALL\": \"Albanian Lek\",\n /* ... */\n}","name":""}]},"settings":""},"next":{"description":"","pages":[]},"title":"/currencies.json","type":"endpoint","slug":"currencies-json","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).","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.","updates":["58b66af72fda9d2300e0e6c8"],"order":2,"isReference":true,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"566b6f17bc5adc0d0096760c","project":"55312174c68f493900aebb3f","category":{"sync":{"isSync":false,"url":""},"pages":["566b438f1766bf0d00e73981","566b51a3f46dc90d009de82a","566b57f068eba90d009cac72","566b6564461c970d0038bfd9","566b6f17bc5adc0d0096760c","566b7c8a03870a0d008ee7a2","566b81db30cdb417008d217b","56a48d9521d3d60d000341f4"],"title":"API Endpoints","slug":"basic-requests","order":1,"from_sync":false,"reference":true,"_id":"566b431d03b4b20d00d02c3a","version":"55312174c68f493900aebb42","__v":8,"createdAt":"2015-12-11T21:41:49.917Z","project":"55312174c68f493900aebb3f"},"editedParams":true,"user":"5531215e29603d2300011341","createdAt":"2015-12-12T00:49:27.509Z","githubsync":"","version":{"version":"0.7","version_clean":"0.7.0","codename":"","is_stable":true,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["55312175c68f493900aebb43","566b431d03b4b20d00d02c3a","566b58f212bc0517005d3068","566b59110506f40d0034f148","566b7cc94d1a4d0d00801c00","566b82d130cdb417008d217d","566b855b4d1a4d0d00801c04","566b856f03870a0d008ee7a7","566c42d2f0a5dc0d009acbab","566c443d85dc790d0062c134"],"_id":"55312174c68f493900aebb42","project":"55312174c68f493900aebb3f","releaseDate":"2015-04-17T15:06:28.598Z","__v":10,"createdAt":"2015-04-17T15:06:28.598Z"},"__v":12,"editedParams2":true,"parentDoc":null}
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
Include alternative currencies.
show_inactive:
boolean0
Include historical/inactive currencies