API kursów kantoru Online
Jeden kantor z aktualnymi kursami kupna i sprzedaży względem PLN. Kursy detaliczne i hurtowe są zwracane osobno: kurs hurtowy obowiązuje dopiero od min_amount_pln i nie wolno go porównywać z detalicznym. Każdy kurs ma własny czas, więc stara oferta nigdy nie jest pokazywana jako dzisiejsza.
GET https://nakordoni.eu/api/v2/data/exchange-office
— klasa limitu: cheap
| Parametr | Opis |
|---|---|
id | Id kantoru z exchange-offices (wymagane) |
lang | Język nazwy miasta i linku do strony (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.office | Wszystkie pola wiersza exchange-offices oraz rates. |
data.office.rates.retail[].currency | Kod ISO 4217; buy i sell to PLN za 1 jednostkę (buy = ile kantor płaci tobie, sell = ile ty płacisz kantorowi). |
data.office.rates.retail[].rate_time | Kiedy ten kurs obowiązywał, ISO 8601 z polskim przesunięciem UTC (np. 2026-10-14T15:47:00+02:00). |
data.office.rates.retail[].is_current | false = kurs jest starszy niż 72 godziny; pokazuj go tylko razem z rate_time. |
data.office.rates.wholesale[].min_amount_pln | Najmniejsza kwota transakcji (w PLN), od której obowiązuje kurs hurtowy; null, gdy kantor jej nie podaje. Pozostałe pola jak w retail. |
data.office.rates.quote_currency | Waluta, w której podawane są wszystkie kursy (PLN). |
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-office",
"data": {
"office": {
"id": 3, "name": "Kantor …", "city": "przemysl", "address": "…, 37-700 Przemyśl",
"lat": 49.78449, "lon": 22.776614, "open_now": false, "has_wholesale": true,
"hours": [ { "day": "mo", "open": "08:00", "close": "17:00" } ],
"rates": {
"quote_currency": "PLN",
"retail": [ { "currency": "EUR", "buy": 4.33, "sell": 4.41,
"rate_time": "2026-10-14T15:47:00+02:00", "is_current": true } ],
"wholesale": [ { "currency": "EUR", "buy": 4.36, "sell": 4.385, "min_amount_pln": 4000,
"rate_time": "2026-10-14T15:47:00+02:00", "is_current": true } ]
}
}
}
}
curl "https://nakordoni.eu/api/v2/data/exchange-office?id=3" \ -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"
Zaktualizowano