Currency API
Currency names and symbols, plus daily exchange rates.
Pass USD, EUR, or JPY. The name, the symbol people recognize, the native symbol, decimal digits, plural name, numeric ISO code and countries using it all come back in the same lookup.
LookupCopy link
GET /currency/{code}API Explorer ↗By ISO 4217 code. Name, symbols and decimal digits
Parameters
- codestring · path · required
ISO 4217 currency code
- langstring · query · optional
Display language as one BCP 47 tag, such as fr or zh-Hant. Changes supported display labels only; IDs, codes, native names, facts, parsing and deep access stay unchanged. Omit for the original response. Unsupported regions use the supported language base; unsupported languages or scripts use English. Missing labels retain their source value. Accept-Language is not read automatically. Available on the current API contract; frozen 1.0.0 is unchanged.
Length: 2 to 64 characters
import { parseAPI } from '@parseapi/sdk';
const parse = parseAPI("YOUR_API_KEY");
const result = await parse.currency("usd");
console.log(result);{
"currency": "USD",
"iso_numeric": 840,
"name": "United States Dollar",
"name_plural": "United States Dollars",
"symbol": "$",
"symbol_native": "$",
"digits": 2,
"countries": [
"AS",
"EC",
"PR",
"US",
"VI"
]
}Response fields
- currencyLink to currencystring or null
- ISO 4217 currency code
- iso_numericLink to iso_numericinteger or null
- ISO 4217 numeric code
- nameLink to namestring or null
- Currency name
- name_pluralLink to name_pluralstring or null
- Plural currency name
- symbolLink to symbolstring or null
- Currency symbol
- symbol_nativeLink to symbol_nativestring or null
- Native / local symbol
- digitsLink to digitsinteger or null
- Minor unit digits (e.g. 2 for USD, 0 for JPY)
- countriesLink to countriesarray or null
- ISO2 countries that use this currency
Exchange rateCopy link
Two codes make a pair. Rates are daily official reference rates from central banks, refreshed after each publish. Coverage is every currency those sources publish, plus statutory pegs. Good for display and estimates, not for settling trades. An unsupported pair returns a 404.
Add ?date=YYYY-MM-DD for a past business day. A weekend or holiday resolves to the last published day on or before it. Older than the held history is a 404. Add ?amount= to convert. The response appends amount and converted, rounded to the quote currency's minor-unit digits.
GET /currency/{base}/{quote}API Explorer ↗Daily official reference rate for a pair. Optional ?date= and ?amount=
Parameters
- basestring · path · required
Base currency code (ISO 4217)
- quotestring · path · required
Quote currency code (ISO 4217)
- datestring · query · optional
YYYY-MM-DD. Official rate for that business day. A weekend or holiday resolves to the last published day on or before it. Older than held history is a 404
- amountnumber · query · optional
Appends amount and converted, rounded to the quote currency minor-unit digits
Response fields
- baseLink to basestring
- Base currency code
- quoteLink to quotestring
- Quote currency code
- rateLink to ratenumber
- Units of quote per 1 unit of base
- dateLink to datestring or null
- Business day the rate was published
- amountLink to amountnumber
- With ?amount= only: echo of the amount asked
- convertedLink to convertednumber or null
- With ?amount= only: amount times rate, rounded to the quote currency minor-unit digits
Display languageCopy link
Pass lang with a language tag such as fr, pt-BR, or zh-Hant. Currency name and name_plural. Each choice covers 154–155 of the 156 current currencies. Rates and currency codes stay unchanged; name_plural is a reference label, not amount-dependent formatting.
Omitting lang preserves the original response. Codes, IDs, numeric facts and native-name fields stay unchanged. Missing translations keep their existing source value; unknown values stay null. A preserved name_local may equal the translated name.
Send a chosen browser preference explicitly, for example { lang: navigator.language } in your JavaScript SDK options. The API does not read Accept-Language automatically. Unsupported regions fall back to their supported base language; unsupported languages or scripts use English. Empty, invalid or repeated tags return 400.
Content-Language identifies languages used in translated display fields and known English fallbacks. Display language is available on API 2.1.0; requests selecting frozen 1.0.0 retain their original contract. See API versions.
33 display language choices
| Language tag | Language |
|---|---|
| en | English |
| ar | العربية |
| ca | català |
| hr | hrvatski |
| cs | čeština |
| da | dansk |
| nl | Nederlands |
| fi | suomi |
| fr | français |
| de | Deutsch |
| el | Ελληνικά |
| he | עברית |
| hi | हिन्दी |
| hu | magyar |
| id | Indonesia |
| it | italiano |
| ja | 日本語 |
| ko | 한국어 |
| ms | Melayu |
| nb | norsk bokmål |
| pl | polski |
| pt | português |
| ro | română |
| ru | русский |
| zh-Hans | 简体中文 |
| sk | slovenčina |
| es | español |
| sv | svenska |
| th | ไทย |
| zh-Hant | 繁體中文 |
| tr | Türkçe |
| uk | українська |
| vi | Tiếng Việt |