Market data · Rates

Market summary for a currency

key optional

get

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

Min / max / average / median of the buying and selling rates across banks. With no date range it is a one-call snapshot of the latest board, open to anonymous callers. Supplying from/to aggregates over that historical window instead and requires an API key, capped at your plan's history depth.

Query parameters

currencyrequiredstring
type"cash" | "transactional": default transactional · cash · transactional
fromstring: Start of the window to summarise over (inclusive), as a YYYY-MM-DD date. Supplying from or to switches from the latest snapshot to a historical aggregate and requires an API key; how far back you may reach is set by your plan.
tostring: End of the window to summarise over (inclusive), as a YYYY-MM-DD date.

Responses

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

Example response

{
  "success": true,
  "data": {
    "currency": "USD",
    "type": "cash",
    "from": "2026-06-01",
    "to": "2026-07-01",
    "bankCount": 26,
    "buying": {
      "min": "155.000000",
      "max": "161.500000",
      "average": "158.250000",
      "median": "158.100000"
    },
    "selling": {
      "min": "155.000000",
      "max": "161.500000",
      "average": "158.250000",
      "median": "158.100000"
    }
  },
  "meta": {
    "timestamp": "2026-07-09T12:00:00.000Z",
    "requestId": "f47ac10b-58cc-4372-a567-0e02b2c3d479"
  }
}

Try it

currency*querytypequeryfromquerytoquery

x-api-key · optional

Request URL

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