One code for the currency record. Two codes for the daily official rate. Add amount to convert, date for a past business day.

Currency code, name, symbols, and decimal places. Add deep=true for numeric code, plural name, and countries using it, included on every plan.

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.

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

Currency API

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

You have two codes. Daily official rate, or convert an amount.

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

Pass two codes

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

Convert an amount

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

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.

18ms

APAC

36ms

LatAm

22ms

84ms

See live status →

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 reference SDKs Keys and authentication

Every response field

Response fields

currency: ISO 4217 currency code
name: Currency name
symbol: Currency symbol
symbol_native: Native / local symbol
digits: Minor unit digits (e.g. 2 for USD, 0 for JPY)

Deep fields

deep.numeric: ISO 4217 numeric code
deep.name_plural: Plural currency name
deep.countries: 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.

Get started Compare plans Read the docs