API היסטוריית שערי המרה Online
היסטוריית השער הקמעונאי של מטבע אחד מול PLN, ללשכה אחת או לעיר שלמה (שער ממוצע ושער הטוב ביותר בין הלשכות שלה), לפי שעה או כממוצעים יומיים, עם שער הייחוס של NBP לאותם ימים. ההיסטוריה נשמרת ל-92 הימים האחרונים; סדרות הלשכות מתחילות ב-2026-10-14, סדרות הערים ב-2026-08-01.
GET https://nakordoni.eu/api/v2/data/exchange-history
— מחלקת מכסה: heavy
| פרמטר | תיאור |
|---|---|
id | id של לשכה מתוך exchange-offices — היסטוריית לשכה (ציינו id או city) |
city | id של עיר מתוך exchange-cities — היסטוריית עיר (ציינו id או city) |
currency | קוד ISO 4217 כמו EUR (חובה) |
days | ימים אחורה מעכשיו, 1-92 (ברירת מחדל 7) |
interval | hour (ברירת מחדל) או day — day מחשב ממוצע לכל יום קלנדרי פולני |
lang | קוד שפה (ברירת מחדל en) |
שדות התשובה — בתוך אובייקט data שבמעטפת התשובה. [] מסמן רשימה, ולכן data.items[].name הוא שדה name של כל פריט. שדה יהיה null, ייעדר או יחזור כרשימה ריקה כשאין לנו ערך עבורו — לעולם לא ערך ממלא מקום.
| שדה | תיאור |
|---|---|
data.points[].time | תחילת השעה (או היום) שהנקודה מכסה, ISO 8601 עם היסט ה-UTC הפולני. |
data.points[].buy | היסטוריית לשכה: שער הקנייה והמכירה של הלשכה (buy, sell) ב-PLN ל-1 יחידה. |
data.points[].avg_buy | היסטוריית עיר: קנייה ומכירה ממוצעות בין הלשכות (avg_buy, avg_sell), הקנייה והמכירה הטובות ביותר (best_buy, best_sell) וכמה לשכות נספרו (offices). |
data.nbp[] | שער האמצע של NBP לכל יום עסקים בחלון (date, mid). |
data.history_since | הנקודה הישנה ביותר שנשמרה בסדרה זו; retention_days מציין כמה אחורה ה-API מגיש נתונים. |
data.scope | office או city, עם id ו-city. |
מאיפה מגיעים הנתונים
את רשימת לשכות ההמרה ואת השערים שלהן Nakordoni אוספת ממידע ציבורי שהלשכות עצמן מפרסמות, בודקת לאיתור שגיאות ומציגה לצד שער הייחוס הרשמי של הבנק הלאומי של פולין (NBP). לכל שער יש את הזמן שבו היה בתוקף; שער ישן מ-72 שעות מסומן is_current: false ולעולם אינו נכנס לדירוג.
לשכות ההמרה יכולות בכל עת לראות מה הבוט שלנו אוסף, לעצור אותו, או לבקש לתקן או להסיר את הרישום שלהן. רישומים שהבעלים ביקש להסיר נעלמים גם מהמוצרים האלה. NakordoniBot ללשכות המרה — מידע ויציאה
כל שורת לשכה כוללת url — הדף שלה ב-nakordoni.eu. קשרו אליו במקום שבו אתם מציגים את הנתונים.
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"
עודכן