Currencies

List currencies available for conversion with ICU-backed name, display precision, symbol placement, and preferred home-country locality.

GET

/api/currencies

Bearer auth

Subject to a daily quota. See Rate limits.

Successful response

HTTP 200

{
  "currencies": [
    {
      "code": "EUR",
      "name": "Euro",
      "country": "Germany",
      "iso2": "DE",
      "symbol": "€",
      "symbol_first": true,
      "decimals": 2,
      "locale": "en_DE"
    },
    {
      "code": "USD",
      "country": "United States of America",
      "symbol": "$"
    },
    {
      "code": "ZAR",
      "country": "South Africa",
      "symbol": "R"
    }
  ]
}

Format an amount

GET /api/currencies/{code}/format?amount=1234.5&locale=en-ZA

The optional locale controls separators and symbol placement. When intl data is unavailable, ezForex returns a deterministic symbol-and-number fallback. This call uses the currencies ability and quota.

Example

curl https://ezforex.your-developer.co.za/api/currencies \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN"

Errors

401 — Missing or invalid Bearer token.
429 — Daily currencies quota exceeded.