API cele mai bune cursuri de schimb Online
Unde să cumpărați sau să vindeți acum o monedă pentru PLN într-un oraș: casele cu cele mai bune cursuri EN-DETAIL, în clasament, lângă cursul oficial de referință NBP. Concurează doar cursuri nu mai vechi de 6 ore, iar cotațiile departe de mediana orașului sunt excluse ca erori probabile. Cursurile en-gros nu intră niciodată în clasament.
GET https://nakordoni.eu/api/v2/data/exchange-best-rates
— clasă de cotă: cheap
| Parametru | Descriere |
|---|---|
city | Id-ul orașului din exchange-cities, de ex. warszawa (obligatoriu) |
currency | Moneda de comparat cu PLN, cod ISO 4217, de ex. EUR (obligatoriu) |
limit | Case pe listă, 1-20 (implicit 5) |
lang | Limba numelui orașului și a linkurilor (implicit en) |
Câmpurile răspunsului — în interiorul obiectului data din plicul răspunsului. [] marchează o listă, deci data.items[].name este câmpul name al fiecărui element. Un câmp este null, lipsește sau este o listă goală atunci când nu avem o valoare — niciodată un substitut.
| Câmp | Descriere |
|---|---|
data.best_to_buy_currency[] | Case cu cel mai MIC curs de vânzare — unde cumpărați moneda cel mai ieftin. rate este acel curs de vânzare în PLN pentru 1 unitate. |
data.best_to_sell_currency[] | Case cu cel mai MARE curs de cumpărare — unde primiți cei mai mulți PLN pentru monedă. |
data.best_to_buy_currency[].vs_nbp_pct | Diferența dintre rate și cursul mediu NBP, în procente. |
data.best_to_buy_currency[].rate_time | Când a fost valabil cursul, ISO 8601 cu decalajul UTC polonez; plus office_id, name, address, lat, lon, buy, sell, spread_pct și url. |
data.candidates | Case cu un curs suficient de recent; sub 2 înseamnă că ambele liste sunt goale — nu există ce compara. |
data.nbp | Cursul de referință al Băncii Naționale a Poloniei: mid (tabelul A), bid/ask (tabelul C) unde se publică, table și effective_date; null pentru o monedă pe care NBP nu o publică. |
data.max_rate_age_minutes | Cel mai vechi curs admis în clasament (360). |
De unde provin datele
Lista caselor de schimb și cursurile lor sunt colectate de Nakordoni din informații publice pe care le publică înseși casele de schimb, verificate pentru erori și afișate lângă cursul oficial de referință al Băncii Naționale a Poloniei (NBP). Fiecare curs are momentul în care a fost valabil; un curs mai vechi de 72 de ore este marcat is_current: false și nu intră niciodată în clasament.
Casele de schimb pot vedea oricând ce colectează botul nostru, îl pot opri sau își pot corecta ori elimina înregistrarea. Înregistrările a căror eliminare a cerut-o proprietarul dispar și din aceste produse. NakordoniBot pentru case de schimb — informații și renunțare
Fiecare rând de casă de schimb conține url — pagina ei pe nakordoni.eu. Puneți un link spre ea acolo unde afișați datele.
Exemplu de răspuns
{
"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"
Actualizat