Get official NBRB currency rata based on ISO 4217 currency code (1 <currency_code> = <N> BYN)

get_currency_rate.py

#!/usr/bin/python3

"""
Get official NBRB currency rata based on ISO 4217 currency code (1 <currency_code> = <N> BYN)

API Documentation: https://www.nbrb.by/bel/apihelp/exrates
"""


import argparse
import requests


def get_currency_rate(base_url: str, currency_iso_code: str, periodicity: int = 0) -> str:
    '''
    Get currency rate by ISO 4217 currency code

        Parameters:
            base_url (str): URL to do request
            currency_iso_code (str): ISO 4217 currency code for which get rate
            periodicity (int): periodicity of rate setting (0 - every day, 1 - every month)
    '''
    url = f'{base_url}/{currency_iso_code}'
    params = {
        'periodicity': periodicity,
        'parammode': 2,
    }

    response = requests.get(url, params=params)
    data = response.json()

    return data['Cur_OfficialRate'] / data['Cur_Scale']


if __name__ == '__main__':
    parser = argparse.ArgumentParser(description='Get currency rate based on ISO 4217')
    parser.add_argument('currency_iso_code', metavar='XXX', type=str,
                        help='ISO 4217 Currency Code')
    args = parser.parse_args()

    BASE_URL = 'https://www.nbrb.by/api/exrates/rates'

    rate = get_currency_rate(BASE_URL, args.currency_iso_code)
    print(rate)