Rates - ezForex

Rates

Download all supported currencies with their exchange rates relative to a specified base currency, using the latest rate snapshot.

GET

/api/rates/{base}

Bearer auth

Subject to a daily quota. See Rate limits.

Path parameters

Name	Type	Description
base	string (3 letters)	Base currency code, e.g. ZAR. Rates are units of each currency per 1 unit of base.

Successful response

HTTP 200

{
  "base": "ZAR",
  "rates": [
    {
      "code": "EUR",
      "country": "Germany",
      "symbol": "€",
      "rate": 0.052517
    },
    {
      "code": "USD",
      "country": "United States of America",
      "symbol": "$",
      "rate": 0.06114
    },
    {
      "code": "ZAR",
      "country": "South Africa",
      "symbol": "R",
      "rate": 1
    }
  ]
}

Each rate is the unrounded cross-rate (units of code per 1 unit of base). Rows also include the same name, ISO2, decimal precision, symbol placement, and locale metadata as the currencies endpoint. The base currency itself always has rate 1.

Example

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

Errors

401 — Missing or invalid Bearer token.
422 — Invalid base currency, conversion disabled, or a required rate is missing.
429 — Daily rates quota exceeded.