Pénzváltó árfolyamok API Online
Egy pénzváltó aktuális vételi és eladási árfolyamai PLN-hez. A kiskereskedelmi és nagykereskedelmi árfolyamok külön érkeznek: a nagykereskedelmi csak min_amount_pln-től érvényes, és nem szabad a kiskereskedelmivel összevetni. Minden árfolyamnak saját időpontja van, így régi jegyzés sosem jelenik meg mainak.
GET https://nakordoni.eu/api/v2/data/exchange-office
— kvótaosztály: cheap
| Paraméter | Leírás |
|---|---|
id | Pénzváltó id az exchange-offices-ból (kötelező) |
lang | A városnév és az oldallink 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.office | Egy exchange-offices sor összes mezője, plusz rates. |
data.office.rates.retail[].currency | ISO 4217 kód; buy és sell PLN 1 egységre (buy = amit a pénzváltó fizet Önnek, sell = amit Ön fizet a pénzváltónak). |
data.office.rates.retail[].rate_time | Mikor volt érvényes az árfolyam, ISO 8601 lengyel UTC-eltolással (pl. 2026-10-14T15:47:00+02:00). |
data.office.rates.retail[].is_current | false = az árfolyam 72 óránál régebbi; csak rate_time-mal együtt mutassa. |
data.office.rates.wholesale[].min_amount_pln | A legkisebb tranzakció (PLN-ben), amelytől a nagykereskedelmi árfolyam érvényes; null, ha a pénzváltó nem adja meg. A többi mező mint a retail-nél. |
data.office.rates.quote_currency | A pénznem, amelyben minden árfolyam jegyzett (PLN). |
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-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"
Frissítve