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"
Ажурирано