Exchange Rate History API Online
Retail rate history for one currency against PLN, either for one office or for a whole city (average and best rate across its offices), hourly or as daily averages, with the NBP reference rate for the same days. History is kept for the last 92 days; office series start on 2026-10-14, city series on 2026-08-01.
GET https://nakordoni.eu/api/v2/data/exchange-history
— quota class: heavy
| Parameter | Description |
|---|---|
id | Office id from exchange-offices — office history (give id or city) |
city | City id from exchange-cities — city history (give id or city) |
currency | ISO 4217 code such as EUR (required) |
days | Days back from now, 1-92 (default 7) |
interval | hour (default) or day — day averages each Polish calendar day |
lang | Language code (default en) |
Response fields — inside the data object of the envelope. [] marks a list, so data.items[].name is the name field of each element. A field is null, absent or an empty list when we hold no value for it — never a placeholder.
| Field | Description |
|---|---|
data.points[].time | Start of the hour (or day) the point covers, ISO 8601 with the Polish UTC offset. |
data.points[].buy | Office history: the office's buy and sell rate in PLN per 1 unit. |
data.points[].avg_buy | City history: average buy and sell across offices (avg_buy, avg_sell), best buy and sell (best_buy, best_sell) and how many offices were counted (offices). |
data.nbp[] | NBP mid rate per business day in the window (date, mid). |
data.history_since | Oldest point held for this series; retention_days is how far back the API serves. |
data.scope | office or city, with id and city. |
Where the data comes from
Office listings and their rates are collected by Nakordoni from public information the exchange offices publish, checked for errors and shown next to the official National Bank of Poland (NBP) reference rate. Every rate carries the time it was valid; a rate older than 72 hours is marked is_current: false and never ranked.
Exchange offices can see what our reader collects, stop it, or correct or remove their listing at any time. Listings an owner asked us to remove disappear from these products too. NakordoniBot for exchange offices — information and opt-out
Each office row carries url — its page on nakordoni.eu. Link it where you show the data.
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"
Updated