CurrencyRateAPI

Gyorsindító eszköz

Szeretnéd tesztelni az API-t anélkül, hogy át kellene böngészned a teljes dokumentációt? Lépj a Vezérlőpultra, ahol megtalálod a Gyorsindító eszközt – egy egyszerű módja annak, hogy egyetlen kattintással kipróbáld az összes elérhető végpontot.

Kattintson az alábbi gombra az ingyenes regisztrációhoz és a Gyorsindító eszköz használatának megkezdéséhez.

Első lépések

A Currency Rate API használatának megkezdéséhez szükséges főbb kifejezések és fogalmak:

API-válasz

A CurrencyRateAPI által megadott árfolyamok alapértelmezés szerint euróban vannak megadva. Minden adat szabványos JSON formátumban kerül visszaadásra, és könnyen elemezhető bármilyen programozási nyelven.

Mintaválasz:
Az alábbiakban egy minta API-választ talál, amely számos elterjedt világvalutát tartalmaz, mindegyiket az EUR pénznemhez viszonyítva, és a beérkezésük időbélyegével együtt.

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

Amint fentebb látható, a valós idejű árfolyamokra vonatkozó API-válasz több kulcsfontosságú mezőt tartalmaz:

• success jelzi, hogy a kérés sikeres volt-e.
• base visszaadja a kéréshez használt alappénznem 3 betűs kódját.
• date visszaadja azt a tényleges dátumot, amelyre az árfolyamok vonatkoznak (ÉÉÉÉ-HH-NN formátumban).
• rates tartalmazza a kért pénznemek listáját és azok aktuális árfolyamait.
• last_update_unix a rendszerben elérhető legfrissebb adatok időbélyegét (Unix formátumban) mutatja.

Elérhető végpontok

A CurrencyRateAPI számos API-végpontot tartalmaz, amelyek mindegyike meghatározott funkciókat kínál. Bizonyos végpontok elérhetősége az előfizetési csomagtól függ.

• A pénznemek listájának végpontja. Ez a végpont az összes támogatott pénznem teljes listáját adja vissza. /api/codes (Alternatív: /api/currencies)
• A legfrissebb árfolyamok végpontja. Ez a végpont valós idejű árfolyamadatokat ad vissza az összes támogatott pénznemre. /api/latest
• A történelmi árfolyamok végpontja. Ez a végpont egy adott dátumra vonatkozó korábbi árfolyamadatokat ad vissza. /api/YYYY-MM-DD (Alternatív: /api/history?date=YYYY-MM-DD). A historikus adatok 1999. január 4-től érhetők el.

Árfolyam-módszertan

Az adatok pontosságának és konzisztenciájának biztosítása érdekében CurrencyRateAPI szigorú módszertant követ az árfolyamok kezelésére és kézbesítésére:

• Középpiaci árak: Alapértelmezés szerint az API mid árfolyamokat ad vissza. Ezek a piaci vételi ( bid ) és eladási ( ask ) árak számtani átlagát, vagy a központi bankok hivatalos referenciaárfolyamait jelentik.
• Napvégi (EOD) véglegesítés: Az API által biztosított historikus árfolyamok a nap végére vonatkozó, UTC (egyetemi koordinált idő) idő szerint véglegesített adatok.
• Keresztráta-számítás: Azon devizapárok esetében, amelyek nem állnak közvetlenül rendelkezésre forrásainkból, a rendszer automatikusan kiszámítja a nagy pontosságú keresztárfolyamokat, a főbb globális valutákat hídként (pivotként) használva.
• Intelligens tartalék mechanizmus: Ha a kért dátumra vonatkozó adatok nem állnak rendelkezésre (például hétvégi vagy ünnepnapi piaci zárvatartás miatt), a rendszer automatikusan megkeresi a legfrissebb érvényes árfolyamot egy csúszó 8 napos időszakon belül.
• Nagy pontosságú: A pénzügyi számításokban előforduló kerekítési hibák elkerülése érdekében az árfolyamokat legfeljebb 18 tizedesjegy pontossággal tároljuk és dolgozzuk fel.

Végpontok

Támogatott szimbólumok végpontja

https://currencyrateapi.com/api/codes

Ez a végpont visszaadja az összes támogatott pénznem teljes listáját. Használhatja az /api/currencies. aliast is.

Az összes támogatott pénznem ember által olvasható listája a Támogatott pénznemek oldalon is elérhető.

Alapvető valuták: Alapértelmezés szerint néhány más végpont (mint például a /latest és a /{YYYY-MM-DD}) a forgalom minimalizálása érdekében a főbb globális pénznemek korlátozott készletét adja vissza. Ezek az „alap” pénznemek a következők:

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-válasz:

{
    "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"
        },
        [...]
    }
}

Válaszobjektumok:

Legfrissebb árfolyamok végpontja

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

Kérés paraméterei:

API-válasz:

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

Válaszobjektumok:

A történelmi árfolyamok végpontja

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

Alternatív formátum: /api/history?date=2025-08-25...

Kérés paraméterei:

API-válasz:

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

Válaszobjektumok:

Mintakód

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'];

JavaScript (lehívás)

 // 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);
    });