API de l'historique des cours de change Online
Historique du cours de détail d'une devise contre PLN, pour un bureau ou pour toute une ville (cours moyen et meilleur cours parmi ses bureaux), à l'heure ou en moyennes journalières, avec le cours de référence NBP des mêmes jours. L'historique est conservé sur les 92 derniers jours ; les séries des bureaux commencent le 2026-10-14, celles des villes le 2026-08-01.
GET https://nakordoni.eu/api/v2/data/exchange-history
— classe de quota: heavy
| Paramètre | Description |
|---|---|
id | Id de bureau issu de exchange-offices — historique du bureau (donner id ou city) |
city | Id de ville issu de exchange-cities — historique de la ville (donner id ou city) |
currency | Code ISO 4217 comme EUR (obligatoire) |
days | Jours en arrière à partir de maintenant, 1-92 (par défaut 7) |
interval | hour (par défaut) ou day — day fait la moyenne de chaque jour calendaire polonais |
lang | Code de langue (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.points[].time | Début de l'heure (ou du jour) couverte par le point, ISO 8601 avec le décalage UTC polonais. |
data.points[].buy | Historique d'un bureau : ses cours d'achat et de vente (buy, sell) en PLN pour 1 unité. |
data.points[].avg_buy | Historique d'une ville : achat et vente moyens sur les bureaux (avg_buy, avg_sell), meilleurs achat et vente (best_buy, best_sell) et nombre de bureaux comptés (offices). |
data.nbp[] | Cours moyen NBP pour chaque jour ouvré de la fenêtre (date, mid). |
data.history_since | Plus ancien point conservé pour cette série ; retention_days indique jusqu'où l'API remonte. |
data.scope | office ou city, avec id et city. |
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.
curl "https://nakordoni.eu/api/v2/data/exchange-history?city=krakow¤cy=EUR&days=30&interval=day" \ -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"
Mis à jour