CBRAPI

cbrapi is a Python client for the Central Bank of Russia's web services.

Table of contents

• CBRAPI main features
• Installation
• Core Functions
  • CURRENCY
  • METALS
  • RATES
  • RESERVES
  • RUONIA
• Getting started
• License

CBRAPI main features

This client provides structured access to the following key data categories from the CBR:

• CURRENCY: Official exchange rates of foreign currencies against the Russian Ruble.
• METALS: Official prices of precious metals.
• RATES: Key interest rates and interbank lending rates.
• RESERVES: Data on international reserves and foreign currency liquidity.
• RUONIA: The Russian Overnight Index Average and related benchmark rates.

Installation

pip install cbrapi

The latest development version can be installed directly from GitHub:

git clone https://github.com/mbk-dev/cbrapi.git
cd cbrapi
poetry install

Core Functions

CURRENCY

Get a list of available currencies

Returns a list of all available currency tickers supported by the API.

get_currencies_list()

Get an internal CBR currency code for a ticker

Retrieves the internal CBR currency code for a given currency ticker.

get_currency_code(ticker: str)

Get currency rate historical data

Fetches historical exchange rate data for a specified currency and date range.

get_time_series(symbol: str, first_date: str, last_date: str, period: str = 'D')

METALS

Get precious metals prices time series

Provides historical prices for precious metals (Gold, Silver, Platinum, Palladium).

get_metals_prices(first_date: str | None = None, last_date: str | None = None, period: str = 'D')

RATES

IBOR: Interbank Offered Rate.

Get the key rate time series

Retrieves the historical key rate set by the Central Bank of Russia.

get_key_rate(first_date: str | None = None, last_date: str | None = None, period: str = 'D')

Get Interbank Offered Rate and related interbank rates

Fetches the historical Interbank Offered Rate and related interbank rates.

get_ibor(first_date: str | None = None, last_date: str | None = None, period: str = 'M')

RESERVES

MRRF: International Reserves and Foreign Currency Liquidity.

Get International Reserves and Foreign Currency Liquidity data

Provides time series data for International Reserves and Foreign Currency Liquidity.

get_mrrf(first_date: str | None = None, last_date: str | None = None, period: str = 'M')

RUONIA

• RUONIA: Russian Overnight Index Average.
• ROISfix: Russian Overnight Index Swap Fixing.

Get RUONIA time series data

Retrieves RUONIA time series data for a specific symbol.

get_ruonia_ts(symbol: str, first_date: str | None = None, last_date: str | None = None, period: str = 'D')

Get RUONIA index and averages time series

Fetches the historical RUONIA index and averages.

get_ruonia_index(first_date: str | None = None, last_date: str | None = None, period: str = 'D')

Get RUONIA overnight value time series

Provides the historical RUONIA overnight value.

get_ruonia_overnight(first_date: str | None = None, last_date: str | None = None, period: str = 'D')

Get ROISfix time series

Retrieves the historical ROISfix time series data.

get_roisfix(first_date: str | None = None, last_date: str | None = None, period: str = 'D')

Getting started

1. Monitor Central Bank's key rate daily changes

import cbrapi as cbr

cbr.get_key_rate("2017-09-13", "2023-09-13").head()

DATE
2017-09-12    9.0
2017-09-13    9.0
2017-09-14    9.0
2017-09-15    9.0
2017-09-16    9.0
Freq: D, Name: KEY_RATE, dtype: float64

2. Track precious metals market trends

cbr.get_metals_prices('2024-01-01', '2025-01-31').head()

3. Monitor ROISfix daily pricing trends

cbr.get_roisfix().head()

License

MIT