NBP SDK

SDK umozliwijące komunikację z API Narodowego Banku Polskiego.

Instalacja

pip install nbp_sdk

Przykładowe uzycie

from nbp_sdk.client import NBPApiClient
from nbp_sdk.types import CurrencyType

api = NBPApiClient() 

currency = api.get_currency_rate_from_today(CurrencyType.EUR)
print(currency)

start_date = datetime(2024, 3, 11)
end_date = datetime(2024, 3, 14) 
currencies = api.get_currency_rate_from_start_date_to_end_date(CurrencyType.EUR, start_date, end_date)
print(currencies)

from nbp_sdk.client import NBPApiClient

api = NBPApiClient() 

gold = api.get_gold_rate_currently_valid()
print(gold)

date = datetime(2024, 3, 14)
gold = api.get_gold_rate_from_working_day_before_date(date)
print(gold)

start_date = datetime(2024, 3, 11)
end_date = datetime(2024, 3, 14) 
golds = api.get_gold_rate_from_start_date_to_end_date(start_date, end_date)
print(golds)

W razie wątpliwości przeczytaj README do końca i rzuć okiem na testy.

Dokumentacja

Dostępne metody

get_currency_rate_currently_valid

Aktualnie obowiązujący kurs waluty w PLN

get_currency_rate_from_today

Kurs waluty w PLN opublikowany w dniu dzisiejszym (albo brak danych)

get_currency_rate_from_date

Kurs waluty opublikowany w dniu {date} (albo brak danych)

get_currency_rate_from_working_day_before_date

Kurs waluty opublikowany w dniu roboczym poprzedzającym podaną datę {date}

Jeśli podasz datę której dzień tygodnia wypada w poniedziałek, kurs zostanie pobrany z piątku. Jeśli podasz datę której dzień tygodnia wypada w środę, kurs zostanie pobrany z wtorku.

get_currency_rate_from_start_date_to_end_date

Seria tabel kursów typu opublikowanych w zakresie dat od {start_date} do {end_date} (albo brak danych)

get_gold_rate_currently_valid

Aktualnie obowiązująca cena złota

get_gold_rate_from_today

Cena złota opublikowana w dniu dzisiejszym (albo brak danych)

get_gold_rate_from_date

Cena złota opublikowana w dniu {date} (albo brak danych)

get_gold_rate_from_working_day_before_date

Cena złota opublikowana w dniu roboczym poprzedzającym podaną datę {date}

Jeśli podasz datę której dzień tygodnia wypada w poniedziałek, kurs zostanie pobrany z piątku. Jeśli podasz datę której dzień tygodnia wypada w środę, kurs zostanie pobrany z wtorku.

get_gold_rate_from_start_date_to_end_date

Seria tabel kursów typu opublikowanych w zakresie dat od {start_date} do {end_date} (albo brak danych)

Zwracane modele

class Currency:
    type: CurrencyType
    # przeliczony kurs średni waluty
    average_rate: Decimal
    table_no: str
    # data publikacji
    effective_date: datetime


class Gold:
    # wyliczona w NBP cena 1 g złota (w próbie 1000)
    rate_per_1g: Decimal
    # data publikacji
    effective_date: datetime

Kontakt

Jeśli będzie Wam czegoś brakowało to dodajcie swoje Issue albo PR, które są oczywiście mile widziane.