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