הוסף מידע
שליחת חדשות וצי NakBus נמצאים כעת בלוח השותפים
חבר את חשבון המפתח שלך לחשבון Nakordoni Partners עם אותו האימייל ונהל שם חדשות ואת צי האוטובוסים שלך (NakDriver / NakManager), עם תפקידי צוות. מפתחות ה-API, נקודות הקצה והאפליקציות שלך נשארים ללא שינוי, והדפים כאן ממשיכים לפעול. פתח את Nakordoni Partners

← כל נקודות הקצה

API שערי ההמרה הטובים ביותר Online

היכן לקנות או למכור עכשיו מטבע אחד תמורת PLN בעיר אחת: הלשכות עם השערים הקמעונאיים הטובים ביותר, מדורגות, לצד שער הייחוס הרשמי של NBP. מתחרים רק שערים שאינם ישנים מ-6 שעות, וציטוטים הרחוקים מאוד מהחציון העירוני מוצאים כשגיאות סבירות. שערים סיטונאיים לעולם אינם נכנסים לדירוג.

GET https://nakordoni.eu/api/v2/data/exchange-best-rates — מחלקת מכסה: cheap

פרמטרתיאור
cityid של עיר מתוך exchange-cities, למשל warszawa (חובה)
currencyמטבע להשוואה מול PLN, קוד ISO 4217 כמו EUR (חובה)
limitלשכות בכל רשימה, 1-20 (ברירת מחדל 5)
langשפת שם העיר וקישורי הדפים (ברירת מחדל en)

שדות התשובה — בתוך אובייקט data שבמעטפת התשובה. [] מסמן רשימה, ולכן data.items[].name הוא שדה name של כל פריט. שדה יהיה null, ייעדר או יחזור כרשימה ריקה כשאין לנו ערך עבורו — לעולם לא ערך ממלא מקום.

שדהתיאור
data.best_to_buy_currency[]לשכות עם שער המכירה הנמוך ביותר — היכן קונים את המטבע בזול ביותר. rate הוא שער המכירה הזה ב-PLN ל-1 יחידה.
data.best_to_sell_currency[]לשכות עם שער הקנייה הגבוה ביותר — היכן מקבלים הכי הרבה PLN עבור המטבע.
data.best_to_buy_currency[].vs_nbp_pctההפרש בין rate לשער האמצע של NBP, באחוזים.
data.best_to_buy_currency[].rate_timeמתי השער היה בתוקף, ISO 8601 עם היסט ה-UTC הפולני; וגם office_id, name, address, lat, lon, buy, sell, spread_pct ו-url.
data.candidatesלשכות עם שער עדכני דיו; פחות מ-2 פירושו ששתי הרשימות ריקות — אין מה להשוות.
data.nbpשער הייחוס של הבנק הלאומי של פולין: mid (טבלה A), bid/ask (טבלה C) היכן שמתפרסמים, table ו-effective_date; null עבור מטבע ש-NBP אינו מפרסם.
data.max_rate_age_minutesהשער הישן ביותר שמותר בדירוג (360).

מאיפה מגיעים הנתונים

את רשימת לשכות ההמרה ואת השערים שלהן Nakordoni אוספת ממידע ציבורי שהלשכות עצמן מפרסמות, בודקת לאיתור שגיאות ומציגה לצד שער הייחוס הרשמי של הבנק הלאומי של פולין (NBP). לכל שער יש את הזמן שבו היה בתוקף; שער ישן מ-72 שעות מסומן is_current: false ולעולם אינו נכנס לדירוג.

לשכות ההמרה יכולות בכל עת לראות מה הבוט שלנו אוסף, לעצור אותו, או לבקש לתקן או להסיר את הרישום שלהן. רישומים שהבעלים ביקש להסיר נעלמים גם מהמוצרים האלה. NakordoniBot ללשכות המרה — מידע ויציאה

כל שורת לשכה כוללת url — הדף שלה ב-nakordoni.eu. קשרו אליו במקום שבו אתם מציגים את הנתונים.

דוגמת תשובה

{
  "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&currency=EUR&limit=5" \
  -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"
🔑 התחברו כמפתחים כדי לנסות את נקודת הקצה הזו בשידור חי ב־Sandbox — 50 קריאות בדיקה חינם ביום. התחברות

עודכן