API истории курсов обмена Online
История розничного курса одной валюты к PLN — для одного пункта или для всего города (средний и лучший курс среди его пунктов), почасово или как дневные средние, вместе со справочным курсом NBP за те же дни. История хранится за последние 92 дня; ряды пунктов начинаются с 2026-10-14, ряды городов — с 2026-08-01.
GET https://nakordoni.eu/api/v2/data/exchange-history
— класс квоты: heavy
| Параметр | Описание |
|---|---|
id | Id пункта из exchange-offices — история пункта (укажите id или city) |
city | Id города из exchange-cities — история города (укажите id или city) |
currency | Код ISO 4217, напр. EUR (обязательно) |
days | Дней назад от текущего момента, 1-92 (по умолчанию 7) |
interval | hour (по умолчанию) или day — day усредняет каждый польский календарный день |
lang | Код языка (по умолчанию en) |
Поля ответа — внутри объекта data в конверте ответа. [] обозначает список, поэтому data.items[].name — это поле name каждого элемента. Поле бывает null, отсутствует или пустой список, если значения у нас нет, — заглушки мы не подставляем.
| Поле | Описание |
|---|---|
data.points[].time | Начало часа (или дня), который охватывает точка, ISO 8601 с польским смещением UTC. |
data.points[].buy | История пункта: курс покупки и продажи пункта (buy, sell) в PLN за 1 единицу. |
data.points[].avg_buy | История города: средние покупка и продажа по пунктам (avg_buy, avg_sell), лучшие покупка и продажа (best_buy, best_sell) и сколько пунктов учтено (offices). |
data.nbp[] | Средний курс NBP за каждый рабочий день в окне (date, mid). |
data.history_since | Самая старая сохранённая точка этого ряда; retention_days — насколько далеко назад отдаёт API. |
data.scope | office или city, вместе с id и city. |
Откуда берутся данные
Список пунктов обмена и их курсы Nakordoni собирает из публичной информации, которую публикуют сами пункты обмена, проверяет на ошибки и показывает рядом с официальным справочным курсом Национального банка Польши (NBP). У каждого курса есть время, когда он действовал; курс старше 72 часов помечен is_current: false и никогда не попадает в рейтинг.
Пункты обмена могут в любой момент увидеть, что собирает наш бот, остановить его, исправить или удалить свою запись. Записи, которые владелец попросил удалить, исчезают и из этих продуктов. NakordoniBot для пунктов обмена — информация и отказ
Каждая строка пункта содержит url — его страницу на nakordoni.eu. Ставьте на неё ссылку там, где показываете данные.
curl "https://nakordoni.eu/api/v2/data/exchange-history?city=krakow¤cy=EUR&days=30&interval=day" \ -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"
Обновлено