GET /currency/{code} · /{base}/{quote}
Currency API
Pass USD to EUR. Get today's official rate.
Try it
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.
Coverage
Daily official rates, with the publish date.
- 250
- countries & territories
- daily
- official rates
Pass USD, EUR, or JPY for the currency name, symbols, and decimal places. Add deep=true for the numeric code, plural name, and countries using it, included on every plan.
For a rate, /currency/usd/eur returns the daily official reference with its publish date. Pass date for a past business day or amount to convert. Country responses already include the currency code.
SPEED
How long /currency takes.
Median time to first byte over the last seven days. Warm requests, measured every 30 minutes. Live verification and other request variants can take longer.
US
21ms
EU
24ms
APAC
46ms
LatAm
17ms
ME
153ms
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.
Make the conversion.
Exchange rates and currency conversion. Every plan.
Start includes 1M API requests a month for $20/mo.
Ready for busy moments.Start includes 1,800 requests per minute, with extra capacity for bursts. Rate limits