L'invio delle notizie e la flotta NakBus sono ora nella dashboard partner
Collega il tuo account sviluppatore a un account Nakordoni Partners con la stessa email e gestisci lì le notizie e la tua flotta di autobus (NakDriver / NakManager), con ruoli di team. Le tue chiavi API, endpoint e app rimangono invariate, e le pagine qui continuano a funzionare. Apri Nakordoni Partners

← Tutti gli endpoint

API migliori tassi di cambio Online

Dove comprare o vendere adesso una valuta contro PLN in una città: gli uffici con i migliori tassi AL DETTAGLIO, in classifica, accanto al tasso di riferimento ufficiale NBP. Competono solo tassi non più vecchi di 6 ore, e le quotazioni lontane dalla mediana cittadina sono escluse come probabili errori. I tassi all'ingrosso non entrano mai nella classifica.

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

ParametroDescrizione
cityId della città da exchange-cities, ad es. warszawa (obbligatorio)
currencyValuta da confrontare con PLN, codice ISO 4217 come EUR (obbligatorio)
limitUffici per elenco, 1-20 (predefinito 5)
langLingua del nome della città e dei link (predefinito en)

Campi della risposta — all’interno dell’oggetto data della busta. [] indica una lista, quindi data.items[].name è il campo name di ogni elemento. Un campo è null, assente o una lista vuota quando non abbiamo un valore — mai un segnaposto.

CampoDescrizione
data.best_to_buy_currency[]Uffici con il tasso di vendita PIÙ BASSO — dove comprate la valuta al prezzo più basso. rate è quel tasso di vendita in PLN per 1 unità.
data.best_to_sell_currency[]Uffici con il tasso di acquisto PIÙ ALTO — dove ottenete più PLN per la valuta.
data.best_to_buy_currency[].vs_nbp_pctDifferenza tra rate e il tasso medio NBP, in percentuale.
data.best_to_buy_currency[].rate_timeQuando il tasso era valido, ISO 8601 con lo scostamento UTC polacco; inoltre office_id, name, address, lat, lon, buy, sell, spread_pct e url.
data.candidatesUffici con un tasso abbastanza recente; meno di 2 significa che entrambi gli elenchi sono vuoti — non c'è nulla da confrontare.
data.nbpTasso di riferimento della Banca nazionale di Polonia: mid (tabella A), bid/ask (tabella C) dove pubblicati, table ed effective_date; null per una valuta che la NBP non pubblica.
data.max_rate_age_minutesTasso più vecchio ammesso in classifica (360).

Da dove provengono i dati

L'elenco degli uffici di cambio e i loro tassi sono raccolti da Nakordoni da informazioni pubbliche che gli uffici stessi pubblicano, controllati per individuare errori e mostrati accanto al tasso di riferimento ufficiale della Banca nazionale di Polonia (NBP). Ogni tasso riporta l'ora in cui era valido; un tasso più vecchio di 72 ore è marcato is_current: false e non entra mai nella classifica.

Gli uffici di cambio possono in qualsiasi momento vedere cosa raccoglie il nostro bot, fermarlo o far correggere o rimuovere la propria scheda. Le schede di cui il titolare ha chiesto la rimozione spariscono anche da questi prodotti. NakordoniBot per gli uffici di cambio — informazioni e opt-out

Ogni riga di ufficio contiene url — la sua pagina su nakordoni.eu. Inserite un link dove mostrate i dati.

Risposta di esempio

{
  "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"
🔑 Accedi come sviluppatore per provare questo endpoint dal vivo nella sandbox — 50 chiamate di prova gratuite al giorno. Accedi

Aggiornato