CurrencyRateAPI

כלי הפעלה מהירה

צריכים לבדוק את ה-API מבלי לחפור בתיעוד מלא? גשו ללוח הבקרה, שם תמצאו את כלי ההפעלה המהירה - דרך פשוטה לנסות את כל נקודות הקצה הזמינות בלחיצה אחת.

לחץ על הכפתור למטה כדי להירשם בחינם ולהתחיל להשתמש בכלי ההפעלה המהירה.

תחילת העבודה

מונחים ומושגים מרכזיים שתצטרכו כדי להתחיל לעבוד עם ממשק ה-API של שער המטבע:

תגובת ה-API

שערי החליפין המסופקים על ידי CurrencyRateAPI הם כברירת מחדל ביורו. כל הנתונים מוחזרים בפורמט JSON סטנדרטי וניתנים לניתוח בקלות באמצעות כל שפת תכנות.

תגובה לדוגמה:
להלן תמצאו תגובת API לדוגמה המכילה מגוון מטבעות נפוצים בעולם, כולם ביחס למטבע האירו ועם חותמת זמן בה הם התקבלו.

{
    "success": true,
    "base": "eur",
    "date": "2025-08-25",
    "rates": {
        "usd": "1.1697",
        "gbp": "0.8659",
        "cad": "1.6171"
    },
    "last_update_unix": "1769067006"
}

כפי שמוצג לעיל, תגובת ה-API עבור שערי חליפין בזמן אמת כוללת מספר שדות מרכזיים:

• success מציין האם הבקשה הצליחה.
• base מחזירה את הקוד בן 3 האותיות של מטבע הבסיס בו נעשה שימוש עבור בקשה זו.
• date מחזירה את התאריך בפועל שעבורו מסופקים שערי החליפין (בפורמט YYYY-MM-DD).
• rates מכיל את רשימת המטבעות המבוקשים ואת שערי החליפין הנוכחיים שלהם.
• last_update_unix מציג את חותמת הזמן (בפורמט יוניקס) של הנתונים העדכניים ביותר הזמינים במערכת.

נקודות קצה זמינות

CurrencyRateAPI כולל מספר נקודות קצה של API, שכל אחת מהן מציעה פונקציונליות ספציפית. זמינותן של נקודות קצה מסוימות תלויה בתוכנית המנוי שלך.

• נקודת הסיום של רשימת המטבעות. נקודת קצה זו מחזירה את הרשימה המלאה של כל המטבעות הנתמכים. /api/codes (חֲלוּפָה: /api/currencies)
• נקודת הסיום של התעריפים העדכניים. נקודת קצה זו מחזירה נתוני שער חליפין בזמן אמת עבור כל המטבעות הנתמכים. /api/latest
• נקודת סיום של שערים היסטוריים. נקודת קצה זו מחזירה נתוני שער חליפין היסטוריים עבור תאריך מסוים. /api/YYYY-MM-DD (חֲלוּפָה: /api/history?date=YYYY-MM-DD). נתונים היסטוריים זמינים החל מ-4 בינואר 1999.

מתודולוגיית שער החליפין

כדי להבטיח דיוק ועקביות בנתונים, CurrencyRateAPI פועל לפי מתודולוגיה קפדנית לניהול ואספקת שערי חליפין:

• שיעורי שוק בינוניים: כברירת מחדל, ה-API מחזיר mid . אלה מייצגים את הממוצע האריתמטי בין מחירי הקנייה ( bid ) ומחירי המכירה ( ask ) בשוק, או שיעורי ייחוס רשמיים מבנקים מרכזיים.
• סיום סוף יום (EOD): שערים היסטוריים המסופקים על ידי ה-API נקבעים סופיים נכון לסוף היום לפי UTC (זמן אוניברסלי מתואם).
• חישוב שער צולב: עבור צמדי מטבעות שאינם זמינים ישירות מהמקורות שלנו, המערכת מחשבת באופן אוטומטי שערים צולבים מדויקים ביותר תוך שימוש במטבעות גלובליים עיקריים כגשר (ציר).
• מנגנון גיבוי חכם: אם נתונים עבור תאריך מבוקש אינם זמינים (למשל, עקב סגירת שווקים בסופי שבוע או חגים), המערכת תחפש אוטומטית את השער התקף העדכני ביותר בתוך חלון הזזה של 8 ימים .
• דיוק גבוה: כדי למנוע שגיאות עיגול בחישובים פיננסיים, שערי חליפין מאוחסנים ומעובדים עם עד 18 ספרות אחרי הנקודה .

נקודות קצה

סמלים נתמכים נקודת קצה

https://currencyrateapi.com/api/codes

נקודת קצה זו מחזירה את הרשימה המלאה של כל המטבעות הנתמכים. ניתן גם להשתמש בכינוי /api/currencies.

רשימה קריאה על ידי בני אדם של כל המטבעות הנתמכים זמינה גם בדף המטבעות הנתמכים שלנו.

מטבעות בסיסיים: כברירת מחדל, נקודות קצה אחרות (כגון /latest ו-/{YYYY-MM-DD}) מחזירות קבוצה מוגבלת של מטבעות גלובליים עיקריים כדי למזער את התנועה. המטבעות ה"בסיסיים" הללו הם:

USD, EUR, GBP, CHF, JPY, CAD, AUD, NZD, SEK, NOK, DKK, ISK, PLN, CZK, HUF, RON, HRK, RSD,
MKD, MDL, TRY, SGD, HKD, KRW, TWD, ILS, AED, SAR, QAR, KWD, BHD, OMR, ZAR

תגובת API:

{
    "success": true,
    "currencies": {
        "EUR": {
            "entity": "EUROPEAN UNION",
            "currency": "Euro",
            "alphabetic_code": "EUR",
            "numeric_code": 978,
            "minor_unit": 2,
            "title": "Euro",
            "symbol": "€",
            "data_from": "1999-01-04"
        },
        "BTC": {
            "entity": "CRYPTOCURRENCY",
            "currency": "Bitcoin",
            "alphabetic_code": "BTC",
            "title": "Bitcoin",
            "symbol": "₿",
            "is_crypto": true,
            "data_from": "2024-03-02"
        },
        [...]
    }
}

אובייקטי תגובה:

נקודת קצה של התעריפים האחרונים

https://currencyrateapi.com/api/latest?
    base=USD&
    quote=GBP,JPY,EUR

פרמטרים של בקשה:

תגובת API:

{
    "success": true,
    "base": "usd",
    "date": "2026-01-22",
    "rates": {
        "gbp": "0.74350935478637",
        "jpy": "158.00358051914",
        "eur": "0.8518613169776"
    },
    "last_update_unix": "1769067006"
}

אובייקטי תגובה:

נקודת סיום של שיעורים היסטוריים

https://currencyrateapi.com/api/2025-08-25?
    base=EUR&
    quote=USD,GBP,CAD

פורמט חלופי: /api/history?date=2025-08-25...

פרמטרים של בקשה:

תגובת API:

{
    "success": true,
    "base": "eur",
    "date": "2025-08-25",
    "rates": {
        "usd": "1.1697",
        "gbp": "0.8659",
        "cad": "1.6171"
    },
    "last_update_unix": "1769067006"
}

אובייקטי תגובה:

קוד לדוגמה

PHP (cURL)

// Set API Endpoint (can be 'latest' or a date 'YYYY-MM-DD')
$endpoint = 'latest';

// Initialize CURL:
$ch = curl_init('https://currencyrateapi.com/api/'.$endpoint.'?base=USD"e=GBP,JPY');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

// Store the data:
$json = curl_exec($ch);
curl_close($ch);

// Decode JSON response:
$exchangeRates = json_decode($json, true);

// Access the exchange rate values, e.g. GBP:
echo $exchangeRates['rates']['GBP'];

ג'אווהסקריפט (אחזור)

 // Set endpoint (can be 'latest' or a date 'YYYY-MM-DD')
const endpoint = 'latest';
const params = '?base=USD"e=GBP,JPY';

// Get exchange rates via the selected endpoint:
fetch('https://currencyrateapi.com/api/' + endpoint + params)
    .then(response => {
        return response.json();
    })
    .then(json => {

        // Exchange rate data is stored in json.rates
        console.log(json.rates.GBP);

        // Timestamp can be accessed in json.last_update_unix
        console.log(json.last_update_unix);
    })
    .catch(error => {
        console.error('Fetch error:', error);
    });