Currency API

Currency API pozwala na pobieranie aktualnych kursów walutowych z Narodowego Banku Polskiego (NBP). API umożliwia sprawdzenie kursu pojedynczej waluty względem PLN lub porównanie dwóch walut między sobą. Dane są aktualizowane codziennie zgodnie z tabelami kursowymi NBP.

Endpoint

https://www.bdfdhub.pl/api/currency/api.php?currency=WALUTA

Parametry

• currency – Określa walutę lub pary walutowe do porównania. Możliwe formaty:
  • usd – Pobiera kurs USD względem PLN.
  • usd,eur – Porównuje kurs USD z EUR.
  • usdeur – Alternatywny format porównania USD z EUR.

Odpowiedź API

API zwraca dane w formacie JSON. Struktura odpowiedzi zależy od liczby podanych walut:

1. Dla jednej waluty (np. ?currency=usd):

• bh.currencyElement – Kod waluty (np. "USD").
• bh.currencyCurrency – Pełna nazwa waluty (np. "dolar amerykański").
• bh.currencyCode – Kod waluty (np. "USD").
• bh.currencyAverage – Średni kurs waluty względem PLN.
• bh.currencyBuy – Kurs kupna (jeśli dostępny).
• bh.currencySell – Kurs sprzedaży (jeśli dostępny).
• bh.currencyDate – Data aktualizacji kursu.
• bh.currencySource – Źródło danych (zawsze "Narodowy Bank Polski (NBP)").

2. Dla dwóch walut (np. ?currency=usd,eur):

• bh.currencyElement – Para walutowa (np. "USD → EUR").
• bh.currencyCurrency1 – Pełna nazwa pierwszej waluty (np. "dolar amerykański").
• bh.currencyCode1 – Kod pierwszej waluty (np. "USD").
• bh.currencyAverage1 – Średni kurs pierwszej waluty względem PLN.
• bh.currencyBuy1 – Kurs kupna pierwszej waluty (jeśli dostępny).
• bh.currencySell1 – Kurs sprzedaży pierwszej waluty (jeśli dostępny).
• bh.currencyDate1 – Data aktualizacji kursu pierwszej waluty.
• bh.currencyCurrency2 – Pełna nazwa drugiej waluty (np. "euro").
• bh.currencyCode2 – Kod drugiej waluty (np. "EUR").
• bh.currencyAverage2 – Średni kurs drugiej waluty względem PLN.
• bh.currencyBuy2 – Kurs kupna drugiej waluty (jeśli dostępny).
• bh.currencySell2 – Kurs sprzedaży drugiej waluty (jeśli dostępny).
• bh.currencyDate2 – Data aktualizacji kursu drugiej waluty.
• bh.conversionRate – Przelicznik między dwoma walutami (np. 1 USD = X EUR).
• bh.currencySource – Źródło danych (zawsze "Narodowy Bank Polski (NBP)").

Przykłady użycia

1. Pobranie kursu USD względem PLN:

https://www.bdfdhub.pl/api/currency/api.php?currency=usd

Odpowiedź:

{
    "bh.currencyElement": "USD",
    "bh.currencyCurrency": "dolar amerykański",
    "bh.currencyCode": "USD",
    "bh.currencyAverage": 4.20,
    "bh.currencyBuy": 4.18,
    "bh.currencySell": 4.22,
    "bh.currencyDate": "2023-10-05",
    "bh.currencySource": "Narodowy Bank Polski (NBP)"
}
    

2. Porównanie kursu USD z EUR:

https://www.bdfdhub.pl/api/currency/api.php?currency=usd,eur

Odpowiedź:

{
    "bh.currencyElement": "USD → EUR",
    "bh.currencyCurrency1": "dolar amerykański",
    "bh.currencyCode1": "USD",
    "bh.currencyAverage1": 4.20,
    "bh.currencyBuy1": 4.18,
    "bh.currencySell1": 4.22,
    "bh.currencyDate1": "2023-10-05",
    "bh.currencyCurrency2": "euro",
    "bh.currencyCode2": "EUR",
    "bh.currencyAverage2": 4.50,
    "bh.currencyBuy2": 4.48,
    "bh.currencySell2": 4.52,
    "bh.currencyDate2": "2023-10-05",
    "bh.conversionRate": 0.9333,
    "bh.currencySource": "Narodowy Bank Polski (NBP)"
}
    

Zastosowania Currency API w botach Discord

Currency API może być używane w botach Discord do różnych celów, takich jak:

• Automatyczne wyświetlanie aktualnych kursów walutowych na kanałach tekstowych.
• Tworzenie komendy, która przelicza kwoty między walutami.
• Powiadomienia o zmianach kursów walutowych.
• Integracja z systemem zarządzania finansami na serwerze Discord.

Przykład użycia w BDFD

1. Pobranie kursu w bocie:

$httpGet[https://www.bdfdhub.pl/api/currency/api.php?currency=$message[1]]
$title[Kurs $httpResult[bh.currencyCode]]
$description[
Średni kurs: $httpResult[bh.currencyAverage] PLN
Kurs kupna: $httpResult[bh.currencyBuy] PLN
Kurs sprzedaży: $httpResult[bh.currencySell] PLN
]
$footer[Data: $httpResult[bh.currencyDate] | Źródło: $httpResult[bh.currencySource]]
    

Przykład wyniku:

Uwagi

• Jeśli podasz tylko jedną walutę (np. ?currency=usd), API zwróci jej kurs względem PLN.
• Jeśli podasz dwie waluty (np. ?currency=usd,eur), API zwróci przelicznik między nimi.
• API obsługuje tylko waluty dostępne w tabelach kursowych NBP.
• Dane są aktualizowane codziennie zgodnie z harmonogramem publikacji kursów NBP.