Ən yaxşı mübadilə məzənnələri API Online
Bir şəhərdə elə indi bir valyutanı PLN-ə harada almaq və ya satmaq olar: ən yaxşı PƏRAKƏNDƏ məzənnələri olan məntəqələr reytinqlə, rəsmi NBP istinad məzənnəsinin yanında. Yalnız 6 saatdan köhnə olmayan məzənnələr yarışır, şəhər medianından çox uzaq təkliflər ehtimal olunan səhv kimi kənarda qalır. Topdan məzənnələr heç vaxt reytinqə daxil olmur.
GET https://nakordoni.eu/api/v2/data/exchange-best-rates
— kvota sinfi: cheap
| Parametr | Təsvir |
|---|---|
city | exchange-cities-dən şəhər id-si, məs. warszawa (məcburi) |
currency | PLN ilə müqayisə ediləcək valyuta, ISO 4217 kodu, məs. EUR (məcburi) |
limit | Hər siyahıda məntəqə sayı, 1-20 (defolt 5) |
lang | Şəhər adının və keçidlərin dili (defolt en) |
Cavab sahələri — cavab zərfindəki data obyektinin içində. [] siyahını bildirir, yəni data.items[].name hər elementin name sahəsidir. Dəyəri olmayan sahə null olur, ümumiyyətlə görünmür və ya boş siyahı qaytarır — heç vaxt doldurucu qoymuruq.
| Sahə | Təsvir |
|---|---|
data.best_to_buy_currency[] | Satış məzənnəsi ƏN AŞAĞI olan məntəqələr — valyutanı ən ucuz alacağınız yer. rate 1 vahid üçün PLN ilə bu satış məzənnəsidir. |
data.best_to_sell_currency[] | Alış məzənnəsi ƏN YÜKSƏK olan məntəqələr — valyuta üçün ən çox PLN alacağınız yer. |
data.best_to_buy_currency[].vs_nbp_pct | rate ilə NBP orta məzənnəsi arasındakı fərq, faizlə. |
data.best_to_buy_currency[].rate_time | Məzənnə nə vaxt qüvvədə olub, Polşa UTC sürüşməsi ilə ISO 8601; həmçinin office_id, name, address, lat, lon, buy, sell, spread_pct və url. |
data.candidates | Kifayət qədər təzə məzənnəsi olan məntəqələr; 2-dən az olması hər iki siyahının boş olduğunu göstərir — müqayisə ediləcək heç nə yoxdur. |
data.nbp | Polşa Milli Bankının istinad məzənnəsi: mid (A cədvəli), dərc olunduğu yerdə bid/ask (C cədvəli), table və effective_date; NBP-nin dərc etmədiyi valyuta üçün null. |
data.max_rate_age_minutes | Reytinqə buraxılan ən köhnə məzənnə (360). |
Məlumatlar haradan gəlir
Mübadilə məntəqələrinin siyahısını və məzənnələrini Nakordoni məntəqələrin özlərinin dərc etdiyi açıq məlumatlardan toplayır, səhvlərə görə yoxlayır və Polşa Milli Bankının (NBP) rəsmi istinad məzənnəsinin yanında göstərir. Hər məzənnə qüvvədə olduğu vaxtı daşıyır; 72 saatdan köhnə məzənnə is_current: false kimi işarələnir və heç vaxt reytinqə daxil olmur.
Mübadilə məntəqələri istənilən vaxt botumuzun nə topladığını görə, onu dayandıra və ya qeydinin düzəldilməsini yaxud silinməsini istəyə bilər. Sahibinin silinməsini istədiyi qeydlər bu məhsullardan da yox olur. Mübadilə məntəqələri üçün NakordoniBot — məlumat və imtina
Hər məntəqə sətrində url var — onun nakordoni.eu-dakı səhifəsi. Məlumatları göstərdiyiniz yerdə ona keçid qoyun.
Cavab nümunəsi
{
"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"
Yeniləndi