Ең тиімді айырбас бағамдары API Online
Бір қалада дәл қазір бір валютаны PLN-ге қайда сатып алуға немесе сатуға болады: ең жақсы БӨЛШЕК бағамдары бар пункттер рейтингпен, NBP ресми анықтамалық бағамының жанында. Тек 6 сағаттан ескі емес бағамдар бәсекелеседі, ал қала медианасынан алыс ұсыныстар ықтимал қате ретінде алынып тасталады. Көтерме бағамдар рейтингке ешқашан кірмейді.
GET https://nakordoni.eu/api/v2/data/exchange-best-rates
— квота класы: cheap
| Параметр | Сипаттама |
|---|---|
city | exchange-cities ішіндегі қала id-і, мысалы warszawa (міндетті) |
currency | PLN-мен салыстырылатын валюта, ISO 4217 коды, мысалы EUR (міндетті) |
limit | Әр тізімдегі пункттер, 1-20 (әдепкі 5) |
lang | Қала атауы мен сілтемелердің тілі (әдепкі en) |
Жауап өрістері — жауап конвертіндегі data объектісінің ішінде. [] тізімді білдіреді, сондықтан data.items[].name — әр элементтің name өрісі. Мәні жоқ өріс null болады, мүлде болмайды немесе бос тізім қайтарады — толтырғышты ешқашан қоймаймыз.
| Өріс | Сипаттама |
|---|---|
data.best_to_buy_currency[] | Сату бағамы ЕҢ ТӨМЕН пункттер — валютаны ең арзанға сатып алатын жер. rate — 1 бірлікке PLN-мен көрсетілген осы сату бағамы. |
data.best_to_sell_currency[] | Сатып алу бағамы ЕҢ ЖОҒАРЫ пункттер — валюта үшін ең көп PLN алатын жер. |
data.best_to_buy_currency[].vs_nbp_pct | rate пен NBP орташа бағамы арасындағы айырма, пайызбен. |
data.best_to_buy_currency[].rate_time | Бағам қашан қолданыста болды, Польшаның UTC ығысуымен ISO 8601; сондай-ақ office_id, name, address, lat, lon, buy, sell, spread_pct және url. |
data.candidates | Бағамы жеткілікті жаңа пункттер; 2-ден аз болса, екі тізім де бос — салыстыратын ештеңе жоқ. |
data.nbp | Польша Ұлттық банкінің анықтамалық бағамы: mid (A кестесі), жарияланатын жерде bid/ask (C кестесі), table және effective_date; NBP жарияламайтын валюта үшін null. |
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"
Жаңартылды