API najlepszych kursów walut Online
Gdzie w danym mieście kupić lub sprzedać jedną walutę za PLN właśnie teraz: kantory z najlepszymi kursami DETALICZNYMI w rankingu, obok oficjalnego kursu referencyjnego NBP. Rywalizują tylko kursy nie starsze niż 6 godzin, a oferty mocno odbiegające od mediany miasta są pomijane jako prawdopodobne błędy. Kursy hurtowe nigdy nie trafiają do rankingu.
GET https://nakordoni.eu/api/v2/data/exchange-best-rates
— klasa limitu: cheap
| Parametr | Opis |
|---|---|
city | Id miasta z exchange-cities, np. warszawa (wymagane) |
currency | Waluta do porównania z PLN, kod ISO 4217, np. EUR (wymagane) |
limit | Kantorów na listę, 1-20 (domyślnie 5) |
lang | Język nazwy miasta i linków do stron (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.best_to_buy_currency[] | Kantory z NAJNIŻSZYM kursem sprzedaży — gdzie walutę kupisz najtaniej. rate to ten kurs sprzedaży w PLN za 1 jednostkę. |
data.best_to_sell_currency[] | Kantory z NAJWYŻSZYM kursem kupna — gdzie za walutę dostaniesz najwięcej PLN. |
data.best_to_buy_currency[].vs_nbp_pct | Różnica między rate a kursem średnim NBP, w procentach. |
data.best_to_buy_currency[].rate_time | Kiedy kurs obowiązywał, ISO 8601 z polskim przesunięciem UTC; także office_id, name, address, lat, lon, buy, sell, spread_pct i url. |
data.candidates | Kantory z wystarczająco świeżym kursem; mniej niż 2 oznacza, że obie listy są puste — nie ma czego porównywać. |
data.nbp | Kurs referencyjny Narodowego Banku Polskiego: mid (tabela A), bid/ask (tabela C), jeśli publikowane, table i effective_date; null dla waluty, której NBP nie publikuje. |
data.max_rate_age_minutes | Najstarszy kurs dopuszczony do rankingu (360). |
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.
Przykładowa odpowiedź
{
"ok": true,
"product": "exchange-best-rates",
"data": {
"city": "warszawa",
"currency": "EUR",
"quote_currency": "PLN",
"kind": "retail",
"candidates": 51,
"best_to_buy_currency": [
{ "office_id": 197, "name": "Kantor …", "rate": 4.38, "buy": 4.365, "sell": 4.38,
"spread_pct": 0.34, "vs_nbp_pct": 0.22, "rate_time": "2026-10-14T21:50:35+02:00",
"url": "https://nakordoni.eu/en/exchange/warszawa/…" }
],
"best_to_sell_currency": [ "…" ],
"nbp": { "currency": "EUR", "mid": 4.3706, "bid": null, "ask": null,
"table": "200/A/NBP/2026", "effective_date": "2026-10-14" }
}
}
curl "https://nakordoni.eu/api/v2/data/exchange-best-rates?city=warszawa¤cy=EUR&limit=5" \ -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"
Zaktualizowano