API kurzů směnárny Online
Jedna směnárna s aktuálními nákupními a prodejními kurzy vůči PLN. Maloobchodní a velkoobchodní kurzy se vracejí odděleně: velkoobchodní platí až od min_amount_pln a nesmí se srovnávat s maloobchodním. Každý kurz nese vlastní čas, takže stará nabídka se nikdy nezobrazí jako dnešní.
GET https://nakordoni.eu/api/v2/data/exchange-office
— třída kvóty: cheap
| Parametr | Popis |
|---|---|
id | Id směnárny z exchange-offices (povinné) |
lang | Jazyk názvu města a odkazu na stránku (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.office | Všechna pole řádku exchange-offices, plus rates. |
data.office.rates.retail[].currency | Kód ISO 4217; buy a sell jsou PLN za 1 jednotku (buy = kolik vám zaplatí směnárna, sell = kolik zaplatíte směnárně). |
data.office.rates.retail[].rate_time | Kdy tento kurz platil, ISO 8601 s polským posunem UTC (např. 2026-10-14T15:47:00+02:00). |
data.office.rates.retail[].is_current | false = kurz je starší než 72 hodin; zobrazujte ho jen spolu s rate_time. |
data.office.rates.wholesale[].min_amount_pln | Nejmenší transakce (v PLN), od které platí velkoobchodní kurz; null, pokud ji směnárna neuvádí. Ostatní pole jako u retail. |
data.office.rates.quote_currency | Měna, ve které jsou kotovány všechny kurzy (PLN). |
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-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"
Aktualizováno