← Docs

Currency API

A currency by ISO code, plus daily exchange rates.

Pass USD, EUR, or JPY. The name, the symbol people recognize, how many digits after the decimal, and every country that spends it.

Lookup

GET
api.parseapi.com/currency/{code}
By ISO 4217 code. Name, symbol, digits, and countries
curl "https://api.parseapi.com/currency/usd" \
  -H "X-API-Key: YOUR_API_KEY"
{
  "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

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=
curl "https://api.parseapi.com/currency/usd/eur" \
  -H "X-API-Key: YOUR_API_KEY"
{
  "base": "USD",
  "quote": "EUR",
  "rate": 0.85888517,
  "date": "2026-08-28"
}
curl "https://api.parseapi.com/currency/usd/eur?date=2026-08-28" \
  -H "X-API-Key: YOUR_API_KEY"
{
  "base": "USD",
  "quote": "EUR",
  "rate": 0.85888517,
  "date": "2026-08-28"
}
curl "https://api.parseapi.com/currency/usd/jpy?amount=100" \
  -H "X-API-Key: YOUR_API_KEY"
{
  "base": "USD",
  "quote": "JPY",
  "rate": 159.68393026,
  "date": "2026-08-28",
  "amount": 100,
  "converted": 15968
}

Response fields

base
Base currency code
quote
Quote currency code
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

Questions? Email