GET /currency/{code} · /{base}/{quote}

Currency API

Pass USD to EUR. Get today's official rate.

Try it

Response/currency/USD/EUR

Run a lookup to see the response.

1M requests · $20/mo. Get started

What comes back.

name

Currency name

symbol

Currency symbol

digits

Minor unit digits (e.g. 2 for USD, 0 for JPY)

deep.countries

ISO2 countries that use this currency

rate

Units of quote per 1 unit of base

date

Business day the rate was published

amount

With ?amount= only: echo of the amount asked

converted

With ?amount= only: amount times rate, rounded to the quote currency minor-unit digits

1

Pass two codes

GET /currency/usd/eur. Daily official reference, with the publish date.

2

Convert an amount

Add amount= for the converted figure, date= for a past business day.

3

Or one code

USD, EUR, JPY. Name, symbols, and decimal places. Add deep=true for the countries using it, on every plan.

Make your first request.

One key works across the APIs. Copy a request in your language and get JSON back.

curl "https://api.parseapi.com/currency/usd" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Parse-Version: 2.0.0"
// Example response · 200
{
  "currency": "USD",
  "name": "United States Dollar",
  "symbol": "$",
  "symbol_native": "$",
  "digits": 2
}

API referenceSDKsKeys and authentication

Every response field

Response fields

currencystring or null
ISO 4217 currency code
namestring or null
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)

Deep fields

deep.numericnumber or null
ISO 4217 numeric code
deep.name_pluralstring or null
Plural currency name
deep.countriesarray
ISO2 countries that use this currency

Build with Currency

All tutorials →

QUESTIONS

When do I use which?
One code for the currency record. Two codes for the daily official rate. Add amount to convert, date for a past business day.
What comes back?
Currency code, name, symbols, and decimal places. Add deep=true for numeric code, plural name, and countries using it, included on every plan.
How do I get a rate?
GET /currency/{base}/{quote}. Daily official reference. Add ?date= for a past business day, ?amount= to convert.
What if that day is a weekend?
The last published business day on or before it. Older than the held history is a 404.

Convert two currencies in the currency converter. Official daily rates.