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

Request

import { parseAPI } from '@parseapi/sdk';

const parse = parseAPI("YOUR_API_KEY");
const result = await parse.currency("usd");
console.log(result);
Example response
{
  "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 tagLanguage
enEnglish
arالعربية
cacatalà
hrhrvatski
csčeština
dadansk
nlNederlands
fisuomi
frfrançais
deDeutsch
elΕλληνικά
heעברית
hiहिन्दी
humagyar
idIndonesia
ititaliano
ja日本語
ko한국어
msMelayu
nbnorsk bokmål
plpolski
ptportuguês
roromână
ruрусский
zh-Hans简体中文
skslovenčina
esespañol
svsvenska
thไทย
zh-Hant繁體中文
trTürkçe
ukукраїнська
viTiếng Việt