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