Market data · Rates

Raw historical rows

key optional

get

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

Every stored row for a currency in a date range — all four columns, one row per bank per day. Requires an API key, and how far back you may query is set by your plan. Page with cursor for a stable walk through a large range, or limit/offset for random access. For a compact one-point-per-day series to plot, use /rates/series, which is open to anonymous callers over a shorter window.

Query parameters

currencyrequiredstring
bankstring
fromstring
tostring
limitnumber: default 100
offsetnumber: default 0
cursorstring: Opaque cursor from a previous response’s pagination.nextCursor. Pages by keyset rather than offset, so rows written mid-walk cannot shift the window and depth costs nothing. Takes precedence over offset when both are sent. Treat it as opaque — its encoding is not part of the contract.

Responses

200: Raw historical rows
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/history?currency=USD'

Example response

{
  "success": true,
  "data": {
    "items": [
      {
        "bankCode": "CBE",
        "bankName": "Commercial Bank of Ethiopia",
        "currency": "USD",
        "cashBuying": "155.234000",
        "cashSelling": "158.338700",
        "transactionalBuying": "156.100000",
        "transactionalSelling": "159.200000",
        "effectiveDate": "2026-07-20"
      }
    ],
    "pagination": {
      "total": 26,
      "limit": 100,
      "offset": 0,
      "hasMore": false,
      "nextCursor": "MjAyNi0wNy0yMHwwMUpF"
    }
  },
  "meta": {
    "timestamp": "2026-07-09T12:00:00.000Z",
    "requestId": "f47ac10b-58cc-4372-a567-0e02b2c3d479"
  }
}

Try it

currency*querybankqueryfromquerytoquerylimitqueryoffsetquerycursorquery

x-api-key · optional

Request URL

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