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.

Lookup

GET

api.parseapi.com/currency/{code}

By ISO 4217 code. Name, symbols and decimal digits

Explore

Parameters 2

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

SDK quickstart

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

const parse = parseAPI("YOUR_API_KEY");
const result = await parse.currency("usd");
console.log(result);

Run on your server with a secret key. Calling from a browser or app?

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

currencystring or null: ISO 4217 currency code
iso_numericinteger or null: ISO 4217 numeric code
namestring or null: Currency name
name_pluralstring or null: Plural currency name
symbolstring or null: Currency symbol
symbol_nativestring or null: Native / local symbol
digitsinteger or null: Minor unit digits (e.g. 2 for USD, 0 for JPY)
countriesarray or null: ISO2 countries that use this currency

Exchange rate

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

api.parseapi.com/currency/{base}/{quote}

Daily official reference rate for a pair. Optional ?date= and ?amount=

Explore

Parameters 4

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

basestring: Base currency code
quotestring: Quote currency code
ratenumber: Units of quote per 1 unit of base
datestring or null: Business day the rate was published
amountnumber: With ?amount= only: echo of the amount asked
convertednumber or null: With ?amount= only: amount times rate, rounded to the quote currency minor-unit digits

Display language

Pass lang with a language tag such as fr, pt-BR, or zh-Hant. Currency name and requested deep.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. This option follows the current API contract. Requests selecting frozen 1.0.0 retain that contract. Select API 2.0.0 to use display language.

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

Build with Currency

All tutorials →

Questions? Email

Currency API

Lookup#

Exchange rate#

Display language#

Build with Currency

Lookup

Exchange rate

Display language