Market data · Rates

Bank ranking for a currency

key optional

get

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

Every bank ranked best→worst for each column (cash/transactional × buy/sell), with each bank’s gap behind the leader in absolute and percentage terms. Banks quoting the current board date (effectiveDate) are ranked first, so the leader is always a live quote; banks still on an older board are kept but sink to the bottom of each column, flagged isStale and carrying their own date. Optional type and side narrow the result to matching columns; omit both for all four. Open to anonymous callers.

Query parameters

currencyrequiredstring
type"cash" | "transactional": Restrict the ranking to one rate type. Omit to include both cash and transactional.cash · transactional
side"buy" | "sell": Restrict the ranking to one side. Omit to include both buy and sell.buy · sell

Responses

200: Bank ranking 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/ranking?currency=USD'

Example response

{
  "success": true,
  "data": {
    "currency": "USD",
    "asOf": "2026-07-20T06:12:00.000Z",
    "effectiveDate": "2026-07-20",
    "rankings": [
      {
        "type": "cash",
        "side": "buy",
        "ranks": [
          {
            "position": 1,
            "bankCode": "CBE",
            "bankName": "Commercial Bank of Ethiopia",
            "rate": "158.338700",
            "deltaFromBest": "0.567000",
            "pctFromBest": "0.3581",
            "effectiveDate": "2026-07-20",
            "isStale": false,
            "change": {
              "previous": "155.500000",
              "current": "156.100000",
              "change": "0.600000",
              "changePct": "0.3859"
            },
            "updatedAt": "2026-07-25T21:20:04.294Z"
          }
        ]
      }
    ]
  },
  "meta": {
    "timestamp": "2026-07-09T12:00:00.000Z",
    "requestId": "f47ac10b-58cc-4372-a567-0e02b2c3d479"
  }
}

Try it

currency*querytypequerysidequery

x-api-key · optional

Request URL

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