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

Name, symbol, decimal places, and the countries that use the code.

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.

name

Currency name

symbol

Currency symbol

digits

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

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, symbol, decimal places, and who uses it.

156 currencies.

Daily official rates. Every plan.

250
countries & territories: daily
official rates

Pass USD, EUR, or JPY and get back the currency name, symbol, decimal places, and which countries use it.

Need a rate? /currency/usd/eur returns the daily official reference, with the publish date. Pass date= for a past business day, amount= to convert. /country/{code} already returns a currency code. Come here for the full record, symbol and all.

RESPONSE

$ curl "https://api.parseapi.com/currency/usd" \
  -H "X-API-Key: YOUR_API_KEY"

// 200 · ~35ms US · ~97ms worldwide
{
  "currency": "USD",
  "numeric": 840,
  "name": "United States Dollar",
  "name_plural": "United States Dollars",
  "symbol": "$",
  "symbol_native": "$",
  "digits": 2,
  "countries": [
    "AS",
    "EC",
    "PR",
    "US",
    "VI"
  ]
}

Response fields

currency: ISO 4217 currency code
numeric: ISO 4217 numeric code
name: Currency name
name_plural: Plural currency name
symbol: Currency symbol
symbol_native: Native / local symbol
digits: Minor unit digits (e.g. 2 for USD, 0 for JPY)
countries: ISO2 countries that use this currency

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?: Name, symbol, decimal places, and the countries that use the code.
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.

SPEED

How long /currency takes.

11ms

12ms

APAC

39ms

LatAm

9ms

120ms

See live status →

Coverage

Daily official rates, with the publish date.

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

Get started Docs