CurrencyRateAPI

Pikakäynnistystyökalu

Haluatko testata API:a ilman, että sinun tarvitsee kaivaa läpi koko dokumentaatiota? Siirry ohjauspaneeliin, josta löydät pikakäynnistystyökalun – yksinkertaisen tavan kokeilla kaikkia käytettävissä olevia päätepisteitä yhdellä napsautuksella.

Rekisteröidy ilmaiseksi ja aloita Quick Launch Toolin käyttö napsauttamalla alla olevaa painiketta.

Aloittaminen

Keskeiset termit ja käsitteet, joita tarvitset aloittaaksesi valuuttakurssi-API:n käytön:

API-vastaus

CurrencyRateAPI:n tarjoamat valuuttakurssit ovat oletusarvoisesti euroissa. Kaikki tiedot palautetaan JSON-vakiomuodossa, ja ne voidaan helposti jäsentää millä tahansa ohjelmointikielellä.

Esimerkkivastaus:
Alta löydät esimerkki-API-vastauksesta, joka sisältää useita yleisiä maailman valuuttoja, kaikki suhteessa EUR-valuuttaan ja vastaanottoaikaleimalla.

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

Kuten yllä on esitetty, reaaliaikaisten valuuttakurssien API-vastaus sisältää useita keskeisiä kenttiä:

• success osoittaa, onnistuiko pyyntö.
• base palauttaa tässä pyynnössä käytetyn perusvaluutan kolmikirjaimisen koodin.
• date palauttaa todellisen päivämäärän, jolle vaihtokurssit annetaan (muodossa VVVV-KK-PP).
• rates sisältää luettelon pyydetyistä valuutoista ja niiden nykyisistä vaihtokursseista.
• last_update_unix näyttää järjestelmässä viimeisimmän saatavilla olevan tiedon aikaleiman (Unix-muodossa).

Käytettävissä olevat päätepisteet

CurrencyRateAPI sisältää useita API-päätepisteitä, joista jokainen tarjoaa tiettyjä toimintoja. Tiettyjen päätepisteiden saatavuus riippuu tilauspaketistasi.

• Valuuttaluettelon päätepiste. Tämä päätepiste palauttaa täydellisen luettelon kaikista tuetuista valuutoista. /api/codes (Vaihtoehto: /api/currencies)
• Viimeisimpien hintojen päätepiste. Tämä päätepiste palauttaa reaaliaikaista valuuttakurssidataa kaikille tuetuille valuutoille. /api/latest
• Historiallisten kurssien päätepiste. Tämä päätepiste palauttaa tietyn päivämäärän historialliset valuuttakurssitiedot. /api/YYYY-MM-DD (Vaihtoehto: /api/history?date=YYYY-MM-DD). Historiatiedot ovat saatavilla 4. tammikuuta 1999 alkaen.

Valuuttakurssimenetelmä

Tietojen tarkkuuden ja johdonmukaisuuden varmistamiseksi CurrencyRateAPI noudattaa tiukkaa menetelmää valuuttakurssien hallinnassa ja toimittamisessa:

• Keskimarkkinoiden hinnat: Oletusarvoisesti API palauttaa mid -kurssit. Nämä edustavat markkinoiden osto- ( bid ) ja myynti- ( ask ) hintojen aritmeettista keskiarvoa tai keskuspankkien virallisia viitekursseja.
• Päivän päättäminen (EOD): API:n tarjoamat historialliset kurssit on viimeistelty päivän päättymisen mukaisesti UTC- ajassa (Coordinated Universal Time).
• Ristikorkolaskenta: Valuuttapareille, jotka eivät ole suoraan saatavilla lähteistämme, järjestelmä laskee automaattisesti erittäin tarkat ristikurssit käyttäen tärkeimpiä maailmanlaajuisia valuuttoja siltana (pivot).
• Älykäs varamekanismi: Jos pyydetyn päivämäärän tiedot eivät ole saatavilla (esim. viikonloppuisin tai pyhäpäivinä tapahtuvien markkinoiden sulkemisten vuoksi), järjestelmä etsii automaattisesti uusimman voimassa olevan kurssin 8 päivän liukuvan aikavälin sisältä.
• Korkea tarkkuus: Pyöristysvirheiden välttämiseksi talouslaskelmissa valuuttakurssit tallennetaan ja käsitellään enintään 18 desimaalin tarkkuudella.

Päätepisteet

Tuettujen symbolien päätepiste

https://currencyrateapi.com/api/codes

Tämä päätepiste palauttaa täydellisen luettelon kaikista tuetuista valuutoista. Voit käyttää myös aliasta /api/currencies.

Ihmisen luettavassa muodossa oleva luettelo kaikista tuetuista valuutoista on saatavilla myös Tuetut valuutat -sivullamme.

Perusvaluutat: Oletusarvoisesti jotkin muut päätepisteet (kuten /latest ja /{YYYY-MM-DD}) palauttavat rajoitetun joukon tärkeimpiä globaaleja valuuttoja liikenteen minimoimiseksi. Nämä "perus"valuutat ovat:

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-vastaus:

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

Vastausobjektit:

Viimeisimmät hinnat Päätepiste

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

Pyyntöparametrit:

API-vastaus:

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

Vastausobjektit:

Historiallisten kurssien päätepiste

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

Vaihtoehtoinen muoto: /api/history?date=2025-08-25...

Pyyntöparametrit:

API-vastaus:

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

Vastausobjektit:

Esimerkkikoodi

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 (nouto)

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