Market data · Banks

One bank’s currencies, with movement

key optional

get

https://api.et-forex.com/api/v1/banks/{code}/board

Every currency this bank quotes for the given type, with its current buying and selling rates and how each has changed since the bank’s previous publication. The transpose of /rates/movers, and unlike it keeps currencies that did not move. Ordered by freshness: the currencies on this bank’s current board (effectiveDate) come first, then any it has not refreshed since, flagged isStale. That per-currency flag is measured against this bank’s own board; the board-level isStale beside effectiveDate is measured against the market, and is the one to show in a header — asOf reports when the bank was last read, which keeps moving for a bank that stopped publishing. Open to anonymous callers.

Path parameters

coderequiredstring: Bank code. Case-insensitive.

Query parameters

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

Responses

200: One bank’s currencies, with movement
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.
404: No such resource, or it is not active — NOT_FOUND. The message names what was looked up.
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/banks/CBE/board'

Example response

{
  "success": true,
  "data": {
    "bankCode": "CBE",
    "bank": "CBE",
    "bankName": "Commercial Bank of Ethiopia",
    "type": "cash",
    "asOf": "2026-07-20T06:12:00.000Z",
    "effectiveDate": "2026-07-20",
    "isStale": false,
    "currencies": [
      {
        "currency": "USD",
        "buying": "155.234000",
        "selling": "158.338700",
        "effectiveDate": "2026-07-20",
        "isStale": false,
        "previousDate": "2026-07-19",
        "buyingChange": {
          "previous": "155.500000",
          "current": "156.100000",
          "change": "0.600000",
          "changePct": "0.3859"
        },
        "sellingChange": {
          "previous": "155.500000",
          "current": "156.100000",
          "change": "0.600000",
          "changePct": "0.3859"
        }
      }
    ]
  },
  "meta": {
    "timestamp": "2026-07-09T12:00:00.000Z",
    "requestId": "f47ac10b-58cc-4372-a567-0e02b2c3d479"
  }
}

Try it

code*pathtypequery

x-api-key · optional

Request URL

https://api.et-forex.com/api/v1/banks/CBE/board