API des cours d'un bureau de change Online
Un bureau de change avec ses cours actuels d'achat et de vente contre PLN. Les cours de détail et de gros sont renvoyés séparément : le gros ne s'applique qu'à partir de min_amount_pln et ne doit pas être comparé au détail. Chaque cours porte sa propre heure, si bien qu'une ancienne cotation n'est jamais présentée comme celle du jour.
GET https://nakordoni.eu/api/v2/data/exchange-office
— classe de quota: cheap
| Paramètre | Description |
|---|---|
id | Id de bureau issu de exchange-offices (obligatoire) |
lang | Langue du nom de ville et du lien 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.office | Tous les champs d'une ligne exchange-offices, plus rates. |
data.office.rates.retail[].currency | Code ISO 4217 ; buy et sell sont en PLN pour 1 unité (buy = ce que le bureau vous paie, sell = ce que vous payez au bureau). |
data.office.rates.retail[].rate_time | Moment où ce cours était valable, ISO 8601 avec le décalage UTC polonais (p. ex. 2026-10-14T15:47:00+02:00). |
data.office.rates.retail[].is_current | false = le cours a plus de 72 heures ; affichez-le uniquement avec rate_time. |
data.office.rates.wholesale[].min_amount_pln | Plus petite transaction (en PLN) à partir de laquelle le cours de gros s'applique ; null si le bureau n'en indique pas. Autres champs comme pour retail. |
data.office.rates.quote_currency | Devise dans laquelle tous les cours sont exprimés (PLN). |
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-office",
"data": {
"office": {
"id": 3, "name": "Kantor …", "city": "przemysl", "address": "…, 37-700 Przemyśl",
"lat": 49.78449, "lon": 22.776614, "open_now": false, "has_wholesale": true,
"hours": [ { "day": "mo", "open": "08:00", "close": "17:00" } ],
"rates": {
"quote_currency": "PLN",
"retail": [ { "currency": "EUR", "buy": 4.33, "sell": 4.41,
"rate_time": "2026-10-14T15:47:00+02:00", "is_current": true } ],
"wholesale": [ { "currency": "EUR", "buy": 4.36, "sell": 4.385, "min_amount_pln": 4000,
"rate_time": "2026-10-14T15:47:00+02:00", "is_current": true } ]
}
}
}
}
curl "https://nakordoni.eu/api/v2/data/exchange-office?id=3" \ -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"
Mis à jour