Айырбас бағамдарының тарихы API Online
Бір валютаның PLN-ге қатысты бөлшек бағамының тарихы — бір пункт үшін немесе бүкіл қала үшін (оның пункттері бойынша орташа және ең жақсы бағам), сағат сайын немесе күндік орташа ретінде, сол күндердің NBP анықтамалық бағамымен. Тарих соңғы 92 күн бойы сақталады; пункт қатарлары 2026-10-14-тен, қала қатарлары 2026-08-01-ден басталады.
GET https://nakordoni.eu/api/v2/data/exchange-history
— квота класы: heavy
| Параметр | Сипаттама |
|---|---|
id | exchange-offices ішіндегі пункт id-і — пункт тарихы (id немесе city беріңіз) |
city | exchange-cities ішіндегі қала id-і — қала тарихы (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 | Нүкте қамтитын сағаттың (немесе күннің) басы, Польшаның UTC ығысуымен ISO 8601. |
data.points[].buy | Пункт тарихы: пункттің 1 бірлікке PLN-мен сатып алу және сату бағамы (buy, sell). |
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"
Жаңартылды