Nachrichteneinreichung und NakBus-Flotte sind jetzt im Partner-Dashboard
Verknüpfen Sie Ihr Entwicklerkonto mit einem Nakordoni-Partners-Konto mit derselben E-Mail-Adresse und verwalten Sie dort Nachrichten sowie Ihre Busflotte (NakDriver / NakManager) mit Teamrollen. Ihre API-Schlüssel, Endpunkte und Apps bleiben unverändert, und die Seiten hier funktionieren weiterhin. Nakordoni Partners öffnen

← Alle Endpunkte

Beste-Wechselkurse-API Online

Wo man in einer Stadt gerade jetzt eine Währung gegen PLN kauft oder verkauft: die Wechselstuben mit den besten EINZELHANDELSkursen als Rangliste, neben dem offiziellen NBP-Referenzkurs. Es konkurrieren nur Kurse, die höchstens 6 Stunden alt sind, und Angebote weit weg vom Stadtmedian werden als wahrscheinliche Fehler ausgelassen. Großhandelskurse kommen nie ins Ranking.

GET https://nakordoni.eu/api/v2/data/exchange-best-rates — Kontingentklasse: cheap

ParameterBeschreibung
cityStadt-id aus exchange-cities, z. B. warszawa (Pflicht)
currencyMit PLN zu vergleichende Währung, ISO-4217-Code wie EUR (Pflicht)
limitWechselstuben pro Liste, 1-20 (Standard 5)
langSprache für Stadtname und Seitenlinks (Standard en)

Antwortfelder — innerhalb des data-Objekts im Antwortumschlag. [] steht für eine Liste, data.items[].name ist also das Feld name jedes Elements. Ein Feld ist null, fehlt oder ist eine leere Liste, wenn wir keinen Wert dafür haben — nie ein Platzhalter.

FeldBeschreibung
data.best_to_buy_currency[]Wechselstuben mit dem NIEDRIGSTEN Verkaufskurs — wo Sie die Währung am günstigsten kaufen. rate ist dieser Verkaufskurs in PLN pro 1 Einheit.
data.best_to_sell_currency[]Wechselstuben mit dem HÖCHSTEN Ankaufskurs — wo Sie für die Währung die meisten PLN bekommen.
data.best_to_buy_currency[].vs_nbp_pctAbweichung zwischen rate und dem NBP-Mittelkurs, in Prozent.
data.best_to_buy_currency[].rate_timeWann der Kurs galt, ISO 8601 mit polnischem UTC-Offset; außerdem office_id, name, address, lat, lon, buy, sell, spread_pct und url.
data.candidatesWechselstuben mit ausreichend aktuellem Kurs; weniger als 2 bedeutet, dass beide Listen leer sind — es gibt nichts zu vergleichen.
data.nbpReferenzkurs der Polnischen Nationalbank: mid (Tabelle A), bid/ask (Tabelle C), soweit veröffentlicht, table und effective_date; null für eine Währung, die die NBP nicht veröffentlicht.
data.max_rate_age_minutesÄltester Kurs, der ins Ranking darf (360).

Woher die Daten stammen

Die Liste der Wechselstuben und ihre Kurse sammelt Nakordoni aus öffentlichen Angaben, die die Wechselstuben selbst veröffentlichen, prüft sie auf Fehler und zeigt sie neben dem offiziellen Referenzkurs der Polnischen Nationalbank (NBP). Jeder Kurs trägt den Zeitpunkt, zu dem er galt; ein Kurs, der älter als 72 Stunden ist, ist mit is_current: false markiert und kommt nie ins Ranking.

Wechselstuben können jederzeit sehen, was unser Bot erfasst, ihn stoppen oder ihren Eintrag korrigieren oder entfernen lassen. Einträge, deren Entfernung der Inhaber verlangt hat, verschwinden auch aus diesen Produkten. NakordoniBot für Wechselstuben — Informationen und Opt-out

Jede Zeile einer Wechselstube enthält url — ihre Seite auf nakordoni.eu. Verlinken Sie sie dort, wo Sie die Daten zeigen.

Beispielantwort

{
  "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&currency=EUR&limit=5" \
  -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"
🔑 Melden Sie sich als Entwickler an, um diesen Endpunkt live in der Sandbox auszuprobieren — 50 kostenlose Testaufrufe pro Tag. Anmelden

Aktualisiert