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