API најбољих курсева размене Online
Где у једном граду управо сада купити или продати једну валуту за PLN: мењачнице са најбољим МАЛОПРОДАЈНИМ курсевима, рангиране, поред званичног референтног курса NBP. Такмиче се само курсеви не старији од 6 сати, а понуде далеко од медијане града изостављају се као вероватне грешке. Велепродајни курсеви никада не улазе у рангирање.
GET https://nakordoni.eu/api/v2/data/exchange-best-rates
— класа квоте: cheap
| Параметар | Опис |
|---|---|
city | Id града из exchange-cities, нпр. warszawa (обавезно) |
currency | Валута за поређење са PLN, ISO 4217 код, нпр. EUR (обавезно) |
limit | Мењачница по листи, 1-20 (подразумевано 5) |
lang | Језик назива града и веза (подразумевано en) |
Поља одговора — унутар објекта data у коверти одговора. [] означава листу, па је data.items[].name поље name сваког елемента. Поље је null, недостаје или је празна листа када немамо вредност — никада не убацујемо замену.
| Поље | Опис |
|---|---|
data.best_to_buy_currency[] | Мењачнице са НАЈНИЖИМ продајним курсом — где валуту купујете најјефтиније. rate је тај продајни курс у PLN за 1 јединицу. |
data.best_to_sell_currency[] | Мењачнице са НАЈВИШИМ куповним курсом — где за валуту добијате највише PLN. |
data.best_to_buy_currency[].vs_nbp_pct | Разлика између rate и средњег курса NBP, у процентима. |
data.best_to_buy_currency[].rate_time | Када је курс важио, ISO 8601 са пољским UTC померајем; такође office_id, name, address, lat, lon, buy, sell, spread_pct и url. |
data.candidates | Мењачнице са довољно свежим курсом; мање од 2 значи да су обе листе празне — нема шта да се пореди. |
data.nbp | Референтни курс Народне банке Пољске: mid (табела A), bid/ask (табела C) где се објављују, table и effective_date; null за валуту коју NBP не објављује. |
data.max_rate_age_minutes | Најстарији курс који се пушта у рангирање (360). |
Одакле потичу подаци
Списак мењачница и њихове курсеве Nakordoni прикупља из јавних информација које објављују саме мењачнице, проверава их на грешке и приказује поред званичног референтног курса Народне банке Пољске (NBP). Сваки курс носи време када је важио; курс старији од 72 сата означен је is_current: false и никада не улази у рангирање.
Мењачнице у сваком тренутку могу да виде шта наш бот прикупља, да га зауставе или да затраже исправку или уклањање свог записа. Записи чије је уклањање власник затражио нестају и из ових производа. NakordoniBot за мењачнице — информације и одјава
Сваки ред мењачнице садржи url — њену страницу на nakordoni.eu. Поставите везу ка њој тамо где приказујете податке.
Пример одговора
{
"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"
Ažurirano