Market data · Conversion

Convert an amount between currencies

key optional

get

https://api.et-forex.com/api/v1/rates/convert

Converts to/from ETB (or across two currencies via ETB). Direction is handled for you: converting to ETB uses the bank buying rate, from ETB the selling rate. With no bank, the most favourable is used.

Query parameters

fromrequiredstring: Currency to convert from — a 3-letter ISO code, or ETB. This is a currency, not a date: the date-range from belongs to /rates/history and /rates/series.
torequiredstring: Currency to convert to — a 3-letter ISO code, or ETB.
amountrequirednumber: Amount of the source currency.
bankstring: Bank to price against. Omitted uses the most favourable bank.
type"cash" | "transactional": default transactional · cash · transactional

Responses

200: Convert an amount between currencies
400: Invalid request — VALIDATION_ERROR.
401: Missing, invalid, revoked or expired credential.
403: Authenticated but not entitled — the plan does not include this endpoint or feature.
429: Rate limit or monthly quota exceeded — RATE_LIMIT_EXCEEDED or QUOTA_EXCEEDED. Honour Retry-After.
500: Unexpected server error.

curl 'https://api.et-forex.com/api/v1/rates/convert?from=USD&to=ETB&amount=100'

Example response

{
  "success": true,
  "data": {
    "from": "USD",
    "to": "ETB",
    "amount": "100",
    "result": "15623.400000",
    "rate": "156.234000",
    "type": "cash",
    "bankCode": "CBE",
    "bankName": "Commercial Bank of Ethiopia",
    "effectiveDate": "2026-07-20"
  },
  "meta": {
    "timestamp": "2026-07-09T12:00:00.000Z",
    "requestId": "f47ac10b-58cc-4372-a567-0e02b2c3d479"
  }
}

Try it

from*queryto*queryamount*querybankquerytypequery

x-api-key · optional

Request URL

https://api.et-forex.com/api/v1/rates/convert?from=USD&to=ETB&amount=100