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