API nejlepších směnných kurzů Online
Kde v jednom městě právě teď koupit nebo prodat jednu měnu za PLN: směnárny s nejlepšími MALOOBCHODNÍMI kurzy v žebříčku, vedle oficiálního referenčního kurzu NBP. Soutěží jen kurzy ne starší než 6 hodin a nabídky daleko od mediánu města se vynechávají jako pravděpodobné chyby. Velkoobchodní kurzy se do žebříčku nikdy nedostanou.
GET https://nakordoni.eu/api/v2/data/exchange-best-rates
— třída kvóty: cheap
| Parametr | Popis |
|---|---|
city | Id města z exchange-cities, např. warszawa (povinné) |
currency | Měna ke srovnání s PLN, kód ISO 4217, např. EUR (povinné) |
limit | Směnáren v seznamu, 1-20 (výchozí 5) |
lang | Jazyk názvu města a odkazů na stránky (výchozí en) |
Pole odpovědi — uvnitř objektu data v obálce odpovědi. [] označuje seznam, takže data.items[].name je pole name každého prvku. Pole bývá null, chybí nebo je prázdný seznam, když pro něj nemáme hodnotu — zástupný údaj nedoplňujeme.
| Pole | Popis |
|---|---|
data.best_to_buy_currency[] | Směnárny s NEJNIŽŠÍM prodejním kurzem — kde měnu koupíte nejlevněji. rate je tento prodejní kurz v PLN za 1 jednotku. |
data.best_to_sell_currency[] | Směnárny s NEJVYŠŠÍM nákupním kurzem — kde za měnu dostanete nejvíc PLN. |
data.best_to_buy_currency[].vs_nbp_pct | Rozdíl mezi rate a středním kurzem NBP, v procentech. |
data.best_to_buy_currency[].rate_time | Kdy kurz platil, ISO 8601 s polským posunem UTC; také office_id, name, address, lat, lon, buy, sell, spread_pct a url. |
data.candidates | Směnárny s dostatečně čerstvým kurzem; méně než 2 znamená, že oba seznamy jsou prázdné — není co srovnávat. |
data.nbp | Referenční kurz Polské národní banky: mid (tabulka A), bid/ask (tabulka C), pokud se zveřejňují, table a effective_date; null pro měnu, kterou NBP nezveřejňuje. |
data.max_rate_age_minutes | Nejstarší kurz připuštěný do žebříčku (360). |
Odkud data pocházejí
Seznam směnáren a jejich kurzy Nakordoni sbírá z veřejných informací, které zveřejňují samy směnárny, kontroluje je na chyby a zobrazuje vedle oficiálního referenčního kurzu Polské národní banky (NBP). Každý kurz nese čas, kdy platil; kurz starší než 72 hodin je označen is_current: false a nikdy se nedostane do žebříčku.
Směnárny mohou kdykoli vidět, co náš bot sbírá, zastavit ho, opravit nebo odstranit svůj záznam. Záznamy, jejichž odstranění vlastník požádal, zmizí i z těchto produktů. NakordoniBot pro směnárny — informace a odhlášení
Každý řádek směnárny obsahuje url — její stránku na nakordoni.eu. Odkažte na ni tam, kde data zobrazujete.
Příklad odpovědi
{
"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"
Aktualizováno