API e kurseve më të mira të këmbimit Online
Ku të blini ose të shisni tani një monedhë për PLN në një qytet: zyrat me kurset më të mira ME PAKICË, të renditura, pranë kursit zyrtar të referencës NBP. Konkurrojnë vetëm kurse jo më të vjetra se 6 orë, dhe kuotimet larg medianës së qytetit lihen jashtë si gabime të mundshme. Kurset me shumicë nuk hyjnë kurrë në renditje.
GET https://nakordoni.eu/api/v2/data/exchange-best-rates
— klasa e kuotës: cheap
| Parametri | Përshkrimi |
|---|---|
city | Id e qytetit nga exchange-cities, p.sh. warszawa (e detyrueshme) |
currency | Monedha për t'u krahasuar me PLN, kod ISO 4217 si EUR (e detyrueshme) |
limit | Zyra për listë, 1-20 (parazgjedhje 5) |
lang | Gjuha e emrit të qytetit dhe e lidhjeve (parazgjedhje en) |
Fushat e përgjigjes — brenda objektit data të zarfit të përgjigjes. [] shënon një listë, pra data.items[].name është fusha name e çdo elementi. Një fushë është null, mungon ose është listë bosh kur nuk kemi vlerë — kurrë një vendmbajtëse.
| Fusha | Përshkrimi |
|---|---|
data.best_to_buy_currency[] | Zyrat me kursin e shitjes MË TË ULËT — ku e blini monedhën më lirë. rate është ky kurs shitjeje në PLN për 1 njësi. |
data.best_to_sell_currency[] | Zyrat me kursin e blerjes MË TË LARTË — ku merrni më shumë PLN për monedhën. |
data.best_to_buy_currency[].vs_nbp_pct | Diferenca midis rate dhe kursit mesatar NBP, në përqindje. |
data.best_to_buy_currency[].rate_time | Kur ishte i vlefshëm kursi, ISO 8601 me zhvendosjen UTC polake; gjithashtu office_id, name, address, lat, lon, buy, sell, spread_pct dhe url. |
data.candidates | Zyra me kurs mjaftueshëm të freskët; më pak se 2 do të thotë se të dyja listat janë bosh — nuk ka çfarë të krahasohet. |
data.nbp | Kursi i referencës i Bankës Kombëtare të Polonisë: mid (tabela A), bid/ask (tabela C) ku publikohen, table dhe effective_date; null për një monedhë që NBP nuk e publikon. |
data.max_rate_age_minutes | Kursi më i vjetër i lejuar në renditje (360). |
Nga vijnë të dhënat
Listën e zyrave të këmbimit dhe kurset e tyre Nakordoni i mbledh nga informacioni publik që publikojnë vetë zyrat e këmbimit, i kontrollon për gabime dhe i shfaq pranë kursit zyrtar të referencës së Bankës Kombëtare të Polonisë (NBP). Çdo kurs mban kohën kur ishte i vlefshëm; një kurs më i vjetër se 72 orë shënohet is_current: false dhe nuk hyn kurrë në renditje.
Zyrat e këmbimit mund të shohin në çdo kohë çfarë mbledh boti ynë, ta ndalin ose të kërkojnë korrigjimin ose heqjen e regjistrimit të tyre. Regjistrimet që pronari ka kërkuar t'i hiqen zhduken edhe nga këto produkte. NakordoniBot për zyrat e këmbimit — informacion dhe tërheqje
Çdo rresht zyre përmban url — faqen e saj në nakordoni.eu. Vendosni një lidhje drejt saj aty ku shfaqni të dhënat.
Shembull përgjigjeje
{
"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"
Përditësuar