Market data · Rates

Chart-ready rate series

key optional

get

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

A compact one-point-per-day series for a currency, ready to plot. With a bank filter it is that bank’s own rate; without one it tracks the best rate across banks each day. Open to anonymous callers over a limited recent window; supplying a key extends that to your plan’s history depth. For bulk or arbitrary-range access, use /rates/history, which is key-only.

Query parameters

currencyrequiredstring
bankstring: Restrict the series to one bank. Omit to track the best rate across all banks each day.
type"cash" | "transactional": default transactional · cash · transactional
side"buy" | "sell": Caller perspective. sell tracks the bank buying rate (the usual "1 unit = N ETB" headline); buy tracks the bank selling rate.default sell · buy · sell
fromstring
tostring

Responses

200: Chart-ready rate series
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/series?currency=USD'

Example response

{
  "success": true,
  "data": {
    "currency": "USD",
    "bank": "CBE",
    "type": "cash",
    "side": "buy",
    "from": "2026-06-01",
    "to": "2026-07-01",
    "points": [
      {
        "date": "2026-07-20",
        "rate": "156.100000",
        "bankCode": "CBE"
      }
    ]
  },
  "meta": {
    "timestamp": "2026-07-09T12:00:00.000Z",
    "requestId": "f47ac10b-58cc-4372-a567-0e02b2c3d479"
  }
}

Try it

currency*querybankquerytypequerysidequeryfromquerytoquery

x-api-key · optional

Request URL

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