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"
Обновено