API historii kursów walut Online
Historia kursu detalicznego jednej waluty względem PLN — dla jednego kantoru lub całego miasta (średni i najlepszy kurs wśród jego kantorów), godzinowo lub jako średnie dzienne, wraz z kursem referencyjnym NBP z tych samych dni. Historia jest przechowywana za ostatnie 92 dni; serie kantorów zaczynają się 2026-10-14, serie miast 2026-08-01.
GET https://nakordoni.eu/api/v2/data/exchange-history
— klasa limitu: heavy
| Parametr | Opis |
|---|---|
id | Id kantoru z exchange-offices — historia kantoru (podaj id albo city) |
city | Id miasta z exchange-cities — historia miasta (podaj id albo city) |
currency | Kod ISO 4217, np. EUR (wymagane) |
days | Liczba dni wstecz od teraz, 1-92 (domyślnie 7) |
interval | hour (domyślnie) lub day — day uśrednia każdy polski dzień kalendarzowy |
lang | Kod języka (domyślnie en) |
Pola odpowiedzi — wewnątrz obiektu data w kopercie odpowiedzi. [] oznacza listę, więc data.items[].name to pole name każdego elementu. Pole bywa null, nieobecne lub jest pustą listą, gdy nie mamy wartości — nigdy nie wstawiamy atrapy.
| Pole | Opis |
|---|---|
data.points[].time | Początek godziny (lub dnia), której dotyczy punkt, ISO 8601 z polskim przesunięciem UTC. |
data.points[].buy | Historia kantoru: kurs kupna i sprzedaży kantoru (buy, sell) w PLN za 1 jednostkę. |
data.points[].avg_buy | Historia miasta: średnie kupno i sprzedaż w kantorach (avg_buy, avg_sell), najlepsze kupno i sprzedaż (best_buy, best_sell) oraz liczba uwzględnionych kantorów (offices). |
data.nbp[] | Kurs średni NBP z każdego dnia roboczego w oknie (date, mid). |
data.history_since | Najstarszy przechowywany punkt tej serii; retention_days mówi, jak daleko wstecz sięga API. |
data.scope | office lub city, wraz z id i city. |
Skąd pochodzą dane
Listę kantorów i ich kursy Nakordoni zbiera z publicznych informacji, które publikują same kantory, sprawdza pod kątem błędów i pokazuje obok oficjalnego kursu referencyjnego Narodowego Banku Polskiego (NBP). Każdy kurs ma czas, w którym obowiązywał; kurs starszy niż 72 godziny jest oznaczony is_current: false i nigdy nie trafia do rankingu.
Kantory mogą w każdej chwili zobaczyć, co zbiera nasz bot, zatrzymać go, poprawić lub usunąć swój wpis. Wpisy, których usunięcia zażądał właściciel, znikają także z tych produktów. NakordoniBot dla kantorów — informacje i rezygnacja
Każdy wiersz kantoru zawiera url — jego stronę na nakordoni.eu. Linkuj do niej tam, gdzie pokazujesz dane.
curl "https://nakordoni.eu/api/v2/data/exchange-history?city=krakow¤cy=EUR&days=30&interval=day" \ -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"
Zaktualizowano