En iyi döviz kurları API'si Online
Bir şehirde şu anda bir para birimini PLN karşılığında nerede alıp satabileceğiniz: en iyi PERAKENDE kurlara sahip bürolar sıralı olarak, resmi NBP referans kurunun yanında. Yalnızca 6 saatten eski olmayan kurlar yarışır; şehir medyanından çok uzak kotasyonlar olası hata olarak dışarıda bırakılır. Toptan kurlar asla sıralamaya girmez.
GET https://nakordoni.eu/api/v2/data/exchange-best-rates
— kota sınıfı: cheap
| Parametre | Açıklama |
|---|---|
city | exchange-cities'ten şehir id'si, ör. warszawa (zorunlu) |
currency | PLN ile karşılaştırılacak para birimi, ISO 4217 kodu, ör. EUR (zorunlu) |
limit | Liste başına büro, 1-20 (varsayılan 5) |
lang | Şehir adı ve sayfa bağlantılarının dili (varsayılan en) |
Yanıt alanları — yanıt zarfındaki data nesnesinin içinde. [] bir listeyi gösterir; yani data.items[].name her öğenin name alanıdır. Değerimiz olmayan bir alan null olur, hiç bulunmaz ya da boş liste döner — asla yer tutucu koymayız.
| Alan | Açıklama |
|---|---|
data.best_to_buy_currency[] | EN DÜŞÜK satış kuruna sahip bürolar — para birimini en ucuza alacağınız yer. rate, 1 birim başına PLN cinsinden bu satış kurudur. |
data.best_to_sell_currency[] | EN YÜKSEK alış kuruna sahip bürolar — para birimi karşılığında en çok PLN alacağınız yer. |
data.best_to_buy_currency[].vs_nbp_pct | rate ile NBP orta kuru arasındaki fark, yüzde olarak. |
data.best_to_buy_currency[].rate_time | Kurun geçerli olduğu zaman, Polonya UTC farkıyla ISO 8601; ayrıca office_id, name, address, lat, lon, buy, sell, spread_pct ve url. |
data.candidates | Yeterince güncel kura sahip bürolar; 2'den az ise iki liste de boştur — karşılaştırılacak bir şey yoktur. |
data.nbp | Polonya Ulusal Bankası referans kuru: mid (A tablosu), yayımlandığı yerde bid/ask (C tablosu), table ve effective_date; NBP'nin yayımlamadığı para birimi için null. |
data.max_rate_age_minutes | Sıralamaya alınan en eski kur (360). |
Veriler nereden geliyor
Döviz bürolarının listesi ve kurları, Nakordoni tarafından büroların kendilerinin yayımladığı kamuya açık bilgilerden toplanır, hatalara karşı kontrol edilir ve Polonya Ulusal Bankası'nın (NBP) resmi referans kurunun yanında gösterilir. Her kur geçerli olduğu zamanı taşır; 72 saatten eski bir kur is_current: false olarak işaretlenir ve asla sıralamaya girmez.
Döviz büroları botumuzun ne topladığını her zaman görebilir, onu durdurabilir ya da kayıtlarını düzelttirebilir veya kaldırtabilir. Sahibinin kaldırılmasını istediği kayıtlar bu ürünlerden de kaybolur. Döviz büroları için NakordoniBot — bilgi ve çıkış
Her büro satırında url bulunur — büronun nakordoni.eu'daki sayfası. Verileri gösterdiğiniz yerde ona bağlantı verin.
Örnek yanıt
{
"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"
Güncellendi