API курсів пункту обміну Online
Один пункт обміну з його поточними курсами купівлі та продажу до PLN. Роздрібні та оптові курси повертаються окремо: оптовий курс діє лише від min_amount_pln і його не можна порівнювати з роздрібним. Кожен курс має власний час, тож старе котирування ніколи не видається за сьогоднішнє.
GET https://nakordoni.eu/api/v2/data/exchange-office
— клас квоти: cheap
| Параметр | Опис |
|---|---|
id | Id пункту з exchange-offices (обов'язково) |
lang | Мова назви міста та посилання на сторінку (за замовчуванням en) |
Поля відповіді — усередині об’єкта data у конверті відповіді. [] позначає список, тож data.items[].name — це поле name кожного елемента. Поле буває null, відсутнє або порожній список, коли значення в нас немає, — заглушок ми не підставляємо.
| Поле | Опис |
|---|---|
data.office | Усі поля рядка exchange-offices, плюс rates. |
data.office.rates.retail[].currency | Код ISO 4217; buy і sell — PLN за 1 одиницю (buy = скільки пункт платить вам, sell = скільки ви платите пункту). |
data.office.rates.retail[].rate_time | Коли цей курс був чинним, ISO 8601 з польським зсувом UTC (напр. 2026-10-14T15:47:00+02:00). |
data.office.rates.retail[].is_current | false = курс старший за 72 години; показуйте його лише разом з rate_time. |
data.office.rates.wholesale[].min_amount_pln | Найменша сума операції (у PLN), від якої діє оптовий курс; null, якщо пункт її не вказує. Інші поля — як у retail. |
data.office.rates.quote_currency | Валюта, в якій котируються всі курси (PLN). |
Звідки беруться дані
Перелік пунктів обміну та їхні курси Nakordoni збирає з публічної інформації, яку публікують самі пункти обміну, перевіряє на помилки та показує поруч з офіційним довідковим курсом Національного банку Польщі (NBP). Кожен курс має час, коли він був чинним; курс, старший за 72 години, позначено is_current: false, і він ніколи не потрапляє в рейтинг.
Пункти обміну можуть будь-коли побачити, що збирає наш бот, зупинити його, виправити або видалити свій запис. Записи, які власник попросив видалити, зникають і з цих продуктів. NakordoniBot для пунктів обміну — інформація та відмова
Кожен рядок пункту містить url — його сторінку на nakordoni.eu. Ставте на неї посилання там, де показуєте дані.
Приклад відповіді
{
"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"
Оновлено