--- title: "Latest CBR exchange rates (RUB base)" method: GET path: "/api/v1/forex/cbr" tags: ["Forex"] --- # Latest CBR exchange rates (RUB base) `GET /api/v1/forex/cbr` Get latest Bank of Russia (CBR) exchange rates with RUB as base currency. Particularly useful for CIS currencies: KZT, GEL, AZN, AMD, BYN, UZS, KGS, TJS - which the ECB reference set does not cover. ## Query parameters - `symbols` string[], nullable — Currency codes to filter (repeat the query parameter). ## Response `200` Bank of Russia daily reference rates with RUB as base. - EnvelopeForexCbrData - `data` ForexCbrData, required - `base` string, nullable — Base currency. - `date` string, nullable — Observation date (YYYY-MM-DD). - `rates` Rates - `AUD` union — Value in Australian Dollar. - integer - number - `AZN` union - integer - number - `DZD` union - integer - number - `GBP` union — Value in British Pound. - integer - number - `AMD` union - integer - number - `BHD` union — Value in Bahraini Dinar. - integer - number - `BYN` union - integer - number - `BOB` union - integer - number - `BRL` union — Value in Brazilian Real. - integer - number - `HUF` union — Value in Hungarian Forint. - integer - number - `VND` union — Value in Vietnamese Dong. - integer - number - `HKD` union — Value in Hong Kong Dollar. - integer - number - `GEL` union — Value in Georgian Lari. - integer - number - `DKK` union — Value in Danish Krone. - integer - number - `AED` union — Value in UAE Dirham. - integer - number - `USD` union — Value denominated in US Dollars. - integer - number - `EUR` union — Value in Euro. - integer - number - `EGP` union - integer - number - `INR` union — Value in Indian Rupee. - integer - number - `IDR` union — Value in Indonesian Rupiah. - integer - number - `IRR` union - integer - number - `KZT` union - integer - number - `CAD` union — Value in Canadian Dollar. - integer - number - `QAR` union - integer - number - `KGS` union - integer - number - `CNY` union — Value in Chinese Yuan. - integer - number - `CUP` union - integer - number - `MDL` union - integer - number - `MNT` union - integer - number - `NGN` union — Value in Nigerian Naira. - integer - number - `NZD` union — Value in New Zealand Dollar. - integer - number - `NOK` union — Value in Norwegian Krone. - integer - number - `OMR` union - integer - number - `PLN` union — Value in Polish Zloty. - integer - number - `SAR` union — Value in Saudi Riyal. - integer - number - `RON` union - integer - number - `XDR` union — Value in IMF Special Drawing Rights. - integer - number - `SGD` union — Value in Singapore Dollar. - integer - number - `TJS` union - integer - number - `THB` union — Value in Thai Baht. - integer - number - `BDT` union — Value in Bangladeshi Taka. - integer - number - `TRY` union - integer - number - `TMT` union - integer - number - `UZS` union - integer - number - `UAH` union — Value in Ukrainian Hryvnia. - integer - number - `CZK` union — Value in Czech Koruna. - integer - number - `SEK` union — Value in Swedish Krona. - integer - number - `CHF` union — Value in Swiss Franc. - integer - number - `ETB` union - integer - number - `RSD` union - integer - number - `ZAR` union — Value in South African Rand. - integer - number - `KRW` union — Value in South Korean Won. - integer - number - `JPY` union — Value in Japanese Yen. - integer - number - `MMK` union — Value in Myanmar Kyat. - integer - number - `meta` SugraMeta, required — Metadata attached to every /api/v1/* response envelope. - `endpoint` string, required — Requested endpoint path. - `data_time` string, required — ISO 8601 UTC timestamp of the source data, not of the request. - `response_time` string, required — ISO 8601 UTC timestamp when this response was produced. - `provider` string, required — API name and version. - `source` string, nullable — Identifier of the primary upstream source used for this response. - `attribution` string, nullable — Human-readable attribution mandated by an upstream source (e.g. a securities regulator or self-regulatory organization). Present only on responses whose source requires the owner and source to be clearly identified. Do not remove or alter it when using the response. - `fallback_used` boolean, nullable — True when the primary source failed and a fallback produced the data. - `fallback_chain` string[], nullable — Ordered list of sources attempted, in the order they were tried. - `cached` boolean, nullable — True when this response was served from the internal cache. - `stale` boolean, nullable — True when the cached response was returned after the upstream rate-limited or errored. Clients can use this to detect degraded data. ## Other responses - `401` — Missing or invalid `x-api-key` header. JSON body with a stable `code` distinguishing `missing_api_key` (no header sent) from `invalid_api_key` (header sent, key not accepted); any other 401 source carries the generic `unauthorized` with its detail as `reason`. Plus `hint`. `plan` is always null on 401 - an unauthenticated request has no plan; quota exhaustion is 429, not 401. - `422` — Validation Error - `429` — Daily rate limit exceeded. Check `X-RateLimit-Reset` for the next window. - `503` — Upstream source is temporarily unavailable. Retry after a short delay. ## Changes - **2026-08-28** `560e8847c7b3` — 60 breaking, 1 info - the response property `data/base` became optional for the status `200` - the response property `data/date` became optional for the status `200` - the response property `data/rates` became optional for the status `200` - response property `data/base` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - …57 more - **2026-08-08** `4c4530760ba1` — 12 info - added the optional property `code` to the response with the `401` status - added the optional property `code` to the response with the `429` status - added the optional property `code` to the response with the `503` status - added the optional property `hint` to the response with the `401` status - …8 more [Change history](https://skmtc.dev/sugra/apis/sugra-api/changes/api/v1/forex/cbr/get.md) --- [API](https://skmtc.dev/sugra/apis/sugra-api.md) · [All operations](https://skmtc.dev/sugra/apis/sugra-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sugra/sugra-api/revisions/87582f2e0110/schema)