Market data · Rates

Buy/sell spread per bank for a currency

key optional

get

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

Each bank’s buying/selling gap for a currency, ranked tightest (cheapest to transact) first, plus how the spread is distributed across the market. Compared on a single publication date (effectiveDate), so a bank that has not published since is not counted. Open to anonymous callers.

Query parameters

currencyrequiredstring
type"cash" | "transactional": default transactional · cash · transactional

Responses

200: Buy/sell spread per bank for a currency
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/spread?currency=USD'

Example response

{
  "success": true,
  "data": {
    "currency": "USD",
    "type": "cash",
    "asOf": "2026-07-20T06:12:00.000Z",
    "effectiveDate": "2026-07-20",
    "market": {
      "min": "155.000000",
      "max": "161.500000",
      "average": "158.250000",
      "median": "158.100000"
    },
    "banks": [
      {
        "bankCode": "CBE",
        "bankName": "Commercial Bank of Ethiopia",
        "buying": "156.100000",
        "selling": "159.200000",
        "spread": "3.100000",
        "spreadPct": "1.9859"
      }
    ]
  },
  "meta": {
    "timestamp": "2026-07-09T12:00:00.000Z",
    "requestId": "f47ac10b-58cc-4372-a567-0e02b2c3d479"
  }
}

Try it

currency*querytypequery

x-api-key · optional

Request URL

https://api.et-forex.com/api/v1/rates/spread?currency=USD