API najlepších výmenných kurzov Online
Kde v jednom meste práve teraz kúpiť alebo predať jednu menu za PLN: zmenárne s najlepšími MALOOBCHODNÝMI kurzami v rebríčku, vedľa oficiálneho referenčného kurzu NBP. Súťažia len kurzy nie staršie ako 6 hodín a ponuky ďaleko od mediánu mesta sa vynechávajú ako pravdepodobné chyby. Veľkoobchodné kurzy sa do rebríčka nikdy nedostanú.
GET https://nakordoni.eu/api/v2/data/exchange-best-rates
— trieda kvóty: cheap
| Parameter | Popis |
|---|---|
city | Id mesta z exchange-cities, napr. warszawa (povinné) |
currency | Mena na porovnanie s PLN, kód ISO 4217, napr. EUR (povinné) |
limit | Zmenární v zozname, 1-20 (predvolene 5) |
lang | Jazyk názvu mesta a odkazov na stránky (predvolene en) |
Polia odpovede — vnútri objektu data v obálke odpovede. [] označuje zoznam, takže data.items[].name je pole name každého prvku. Pole býva null, chýba alebo je prázdny zoznam, keď preň nemáme hodnotu — zástupný údaj nedopĺňame.
| Pole | Popis |
|---|---|
data.best_to_buy_currency[] | Zmenárne s NAJNIŽŠÍM predajným kurzom — kde menu kúpite najlacnejšie. rate je tento predajný kurz v PLN za 1 jednotku. |
data.best_to_sell_currency[] | Zmenárne s NAJVYŠŠÍM nákupným kurzom — kde za menu dostanete najviac PLN. |
data.best_to_buy_currency[].vs_nbp_pct | Rozdiel medzi rate a stredným kurzom NBP, v percentách. |
data.best_to_buy_currency[].rate_time | Kedy kurz platil, ISO 8601 s poľským posunom UTC; tiež office_id, name, address, lat, lon, buy, sell, spread_pct a url. |
data.candidates | Zmenárne s dostatočne čerstvým kurzom; menej ako 2 znamená, že oba zoznamy sú prázdne — nie je čo porovnať. |
data.nbp | Referenčný kurz Poľskej národnej banky: mid (tabuľka A), bid/ask (tabuľka C), ak sú zverejnené, table a effective_date; null pre menu, ktorú NBP nezverejňuje. |
data.max_rate_age_minutes | Najstarší kurz pripustený do rebríčka (360). |
Odkiaľ pochádzajú údaje
Zoznam zmenární a ich kurzy Nakordoni zbiera z verejných informácií, ktoré zverejňujú samotné zmenárne, kontroluje ich na chyby a zobrazuje vedľa oficiálneho referenčného kurzu Poľskej národnej banky (NBP). Každý kurz nesie čas, kedy platil; kurz starší ako 72 hodín je označený is_current: false a nikdy sa nedostane do rebríčka.
Zmenárne môžu kedykoľvek vidieť, čo náš bot zbiera, zastaviť ho, opraviť alebo odstrániť svoj záznam. Záznamy, ktorých odstránenie vlastník požiadal, zmiznú aj z týchto produktov. NakordoniBot pre zmenárne — informácie a odhlásenie
Každý riadok zmenárne obsahuje url — jej stránku na nakordoni.eu. Odkážte na ňu tam, kde zobrazujete údaje.
Príklad odpovede
{
"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"
Aktualizované