Legjobb váltási árfolyamok API Online
Hol lehet egy városban most egy pénznemet PLN-ért venni vagy eladni: a legjobb KISKERESKEDELMI árfolyamú pénzváltók rangsorban, a hivatalos NBP referencia-árfolyam mellett. Csak legfeljebb 6 órás árfolyamok versenyeznek, a városi mediántól messze eső jegyzések valószínű hibaként kimaradnak. Nagykereskedelmi árfolyam sosem kerül a rangsorba.
GET https://nakordoni.eu/api/v2/data/exchange-best-rates
— kvótaosztály: cheap
| Paraméter | Leírás |
|---|---|
city | Város id az exchange-cities-ből, pl. warszawa (kötelező) |
currency | A PLN-nel összevetendő pénznem, ISO 4217 kód, pl. EUR (kötelező) |
limit | Pénzváltók listánként, 1-20 (alapértelmezés 5) |
lang | A városnév és az oldallinkek nyelve (alapértelmezés en) |
Válaszmezők — a válaszboríték data objektumán belül. A [] listát jelöl, tehát a data.items[].name az egyes elemek name mezője. Egy mező null, hiányzik vagy üres lista, ha nincs rá értékünk — helykitöltőt soha nem teszünk oda.
| Mező | Leírás |
|---|---|
data.best_to_buy_currency[] | A LEGALACSONYABB eladási árfolyamú pénzváltók — itt veheti a legolcsóbban a pénznemet. rate ez az eladási árfolyam PLN-ben 1 egységre. |
data.best_to_sell_currency[] | A LEGMAGASABB vételi árfolyamú pénzváltók — itt kapja a legtöbb PLN-t a pénznemért. |
data.best_to_buy_currency[].vs_nbp_pct | A rate és az NBP középárfolyam közötti eltérés, százalékban. |
data.best_to_buy_currency[].rate_time | Mikor volt érvényes az árfolyam, ISO 8601 lengyel UTC-eltolással; továbbá office_id, name, address, lat, lon, buy, sell, spread_pct és url. |
data.candidates | Elég friss árfolyamú pénzváltók; 2 alatt mindkét lista üres — nincs mit összevetni. |
data.nbp | A Lengyel Nemzeti Bank referencia-árfolyama: mid (A táblázat), bid/ask (C táblázat), ahol közzéteszik, table és effective_date; null olyan pénznemnél, amelyet az NBP nem tesz közzé. |
data.max_rate_age_minutes | A rangsorba engedett legrégebbi árfolyam (360). |
Honnan származnak az adatok
A pénzváltók listáját és árfolyamaikat a Nakordoni a pénzváltók által maguk közzétett nyilvános információkból gyűjti, hibákra ellenőrzi, és a Lengyel Nemzeti Bank (NBP) hivatalos referencia-árfolyama mellett mutatja. Minden árfolyamhoz tartozik az időpont, amikor érvényes volt; a 72 óránál régebbi árfolyam jelölése is_current: false, és sosem kerül rangsorba.
A pénzváltók bármikor megnézhetik, mit gyűjt a botunk, leállíthatják, illetve javíttathatják vagy töröltethetik a bejegyzésüket. Azok a bejegyzések, amelyek törlését a tulajdonos kérte, ezekből a termékekből is eltűnnek. NakordoniBot pénzváltóknak — tájékoztató és leiratkozás
Minden pénzváltó-sor tartalmazza az url mezőt — az oldalát a nakordoni.eu-n. Linkelje ott, ahol az adatokat megjeleníti.
Példaválasz
{
"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"
Frissítve