API des meilleurs cours de change Online
Où acheter ou vendre une devise contre des PLN dans une ville en ce moment : les bureaux aux meilleurs cours de DÉTAIL, classés, à côté du cours de référence officiel NBP. Seuls les cours de moins de 6 heures sont en concurrence, et les cotations très éloignées de la médiane de la ville sont écartées comme erreurs probables. Les cours de gros n'entrent jamais dans le classement.
GET https://nakordoni.eu/api/v2/data/exchange-best-rates
— classe de quota: cheap
| Paramètre | Description |
|---|---|
city | Id de ville issu de exchange-cities, p. ex. warszawa (obligatoire) |
currency | Devise à comparer au PLN, code ISO 4217 comme EUR (obligatoire) |
limit | Bureaux par liste, 1-20 (par défaut 5) |
lang | Langue du nom de ville et des liens de page (par défaut en) |
Champs de la réponse — à l’intérieur de l’objet data de l’enveloppe. [] indique une liste : data.items[].name est donc le champ name de chaque élément. Un champ vaut null, est absent ou est une liste vide quand nous n’avons pas de valeur — jamais un espace réservé.
| Champ | Description |
|---|---|
data.best_to_buy_currency[] | Bureaux au cours de vente le PLUS BAS — où acheter la devise le moins cher. rate est ce cours de vente en PLN pour 1 unité. |
data.best_to_sell_currency[] | Bureaux au cours d'achat le PLUS ÉLEVÉ — où obtenir le plus de PLN pour la devise. |
data.best_to_buy_currency[].vs_nbp_pct | Écart entre rate et le cours moyen NBP, en pourcentage. |
data.best_to_buy_currency[].rate_time | Moment où le cours était valable, ISO 8601 avec le décalage UTC polonais ; aussi office_id, name, address, lat, lon, buy, sell, spread_pct et url. |
data.candidates | Bureaux avec un cours suffisamment récent ; moins de 2 signifie que les deux listes sont vides — il n'y a rien à comparer. |
data.nbp | Cours de référence de la Banque nationale de Pologne : mid (table A), bid/ask (table C) lorsqu'ils sont publiés, table et effective_date ; null pour une devise que la NBP ne publie pas. |
data.max_rate_age_minutes | Cours le plus ancien admis dans le classement (360). |
D'où viennent les données
La liste des bureaux de change et leurs cours sont collectés par Nakordoni à partir d'informations publiques que les bureaux de change publient eux-mêmes, vérifiés contre les erreurs et affichés à côté du cours de référence officiel de la Banque nationale de Pologne (NBP). Chaque cours porte l'heure à laquelle il était valable ; un cours de plus de 72 heures est marqué is_current: false et n'entre jamais dans le classement.
Les bureaux de change peuvent à tout moment voir ce que collecte notre robot, l'arrêter, ou faire corriger ou retirer leur fiche. Les fiches dont le propriétaire a demandé le retrait disparaissent aussi de ces produits. NakordoniBot pour les bureaux de change — informations et retrait
Chaque ligne de bureau contient url — sa page sur nakordoni.eu. Mettez-y un lien là où vous affichez les données.
Exemple de réponse
{
"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"
Mis à jour