API de mejores tipos de cambio Online
Dónde comprar o vender ahora una moneda por PLN en una ciudad: las casas con los mejores tipos MINORISTAS, clasificadas, junto al tipo de referencia oficial del NBP. Solo compiten tipos de hasta 6 horas, y las cotizaciones muy alejadas de la mediana de la ciudad se descartan como probables errores. Los tipos mayoristas nunca entran en la clasificación.
GET https://nakordoni.eu/api/v2/data/exchange-best-rates
— clase de cuota: cheap
| Parámetro | Descripción |
|---|---|
city | Id de ciudad de exchange-cities, p. ej. warszawa (obligatorio) |
currency | Moneda a comparar con el PLN, código ISO 4217 como EUR (obligatorio) |
limit | Casas por lista, 1-20 (por defecto 5) |
lang | Idioma del nombre de ciudad y de los enlaces (por defecto en) |
Campos de la respuesta — dentro del objeto data del sobre de respuesta. [] indica una lista, así que data.items[].name es el campo name de cada elemento. Un campo es null, no aparece o es una lista vacía cuando no tenemos valor: nunca un marcador de posición.
| Campo | Descripción |
|---|---|
data.best_to_buy_currency[] | Casas con el tipo de venta MÁS BAJO — donde comprar la moneda más barata. rate es ese tipo de venta en PLN por 1 unidad. |
data.best_to_sell_currency[] | Casas con el tipo de compra MÁS ALTO — donde obtener más PLN por la moneda. |
data.best_to_buy_currency[].vs_nbp_pct | Diferencia entre rate y el tipo medio del NBP, en porcentaje. |
data.best_to_buy_currency[].rate_time | Cuándo era válido el tipo, ISO 8601 con el desfase UTC polaco; además office_id, name, address, lat, lon, buy, sell, spread_pct y url. |
data.candidates | Casas con un tipo suficientemente reciente; menos de 2 significa que ambas listas están vacías — no hay nada que comparar. |
data.nbp | Tipo de referencia del Banco Nacional de Polonia: mid (tabla A), bid/ask (tabla C) cuando se publican, table y effective_date; null para una moneda que el NBP no publica. |
data.max_rate_age_minutes | Tipo más antiguo admitido en la clasificación (360). |
De dónde vienen los datos
Nakordoni recopila el listado de casas de cambio y sus tipos a partir de información pública que publican las propias casas de cambio, los revisa en busca de errores y los muestra junto al tipo de referencia oficial del Banco Nacional de Polonia (NBP). Cada tipo lleva la hora en que era válido; un tipo con más de 72 horas se marca is_current: false y nunca entra en la clasificación.
Las casas de cambio pueden ver en cualquier momento qué recopila nuestro bot, detenerlo o pedir que se corrija o elimine su ficha. Las fichas cuya eliminación pidió el propietario desaparecen también de estos productos. NakordoniBot para casas de cambio — información y exclusión
Cada fila de casa de cambio incluye url — su página en nakordoni.eu. Enlácela donde muestre los datos.
Respuesta de ejemplo
{
"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"
Actualizado