CurrencyRateAPI

Nástroj pro rychlé spuštění

Potřebujete otestovat API, aniž byste se museli prohrabávat v celé dokumentaci? Přejděte do Ovládacích panelů, kde najdete Nástroj Rychlé spuštění – jednoduchý způsob, jak vyzkoušet všechny dostupné koncové body jediným kliknutím.

Klikněte na tlačítko níže pro bezplatnou registraci a začněte používat Nástroj pro rychlé spuštění.

Začínáme

Klíčové pojmy a koncepty, které budete potřebovat pro začátek práce s API pro kurzy měn:

Odpověď API

Směnné kurzy poskytované CurrencyRateAPI jsou standardně v eurech. Všechna data jsou vrácena ve standardním formátu JSON a lze je snadno analyzovat pomocí libovolného programovacího jazyka.

Ukázková odpověď:
Níže naleznete ukázkovou odpověď API obsahující řadu běžných světových měn, všechny vztažené k měně EUR a s časovým razítkem, ve kterém byly přijaty.

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

Jak je uvedeno výše, odpověď API pro směnné kurzy v reálném čase obsahuje několik klíčových polí:

• success označuje, zda byl požadavek úspěšný.
• base vrací třípísmenný kód základní měny použité pro tento požadavek.
• date vrací skutečné datum, pro které jsou směnné kurzy poskytnuty (formát RRRR-MM-DD).
• rates obsahuje seznam požadovaných měn a jejich aktuální směnné kurzy.
• last_update_unix zobrazuje časové razítko (ve formátu Unix) nejnovějších dostupných dat v systému.

Dostupné koncové body

CurrencyRateAPI obsahuje několik koncových bodů API, z nichž každý nabízí specifické funkce. Dostupnost určitých koncových bodů závisí na vašem předplatném.

• Koncový bod seznamu měn. Tento koncový bod vrací úplný seznam všech podporovaných měn. /api/codes (Alternativní: /api/currencies)
• Konečný bod nejnovějších sazeb. Tento koncový bod vrací data o směnných kurzech v reálném čase pro všechny podporované měny. /api/latest
• Koncový bod historických sazeb. Tento koncový bod vrací historická data směnného kurzu pro konkrétní datum. /api/YYYY-MM-DD (Alternativní: /api/history?date=YYYY-MM-DD). Historická data jsou k dispozici od 4. ledna 1999.

Metodika směnných kurzů

Pro zajištění přesnosti a konzistence dat se CurrencyRateAPI řídí přísnou metodologií pro správu a poskytování směnných kurzů:

• Střední tržní sazby: Ve výchozím nastavení API vrací mid sazby. Ty představují aritmetický průměr mezi tržní nákupní ( bid ) a prodejní ( ask ) cenou nebo oficiálními referenčními sazbami centrálních bank.
• Finalizace na konci dne (EOD): Historické sazby poskytované rozhraním API jsou finalizovány ke konci dne v UTC (koordinovaný světový čas).
• Výpočet křížového kurzu: Pro měnové páry, které nejsou přímo dostupné z našich zdrojů, systém automaticky vypočítává vysoce přesné křížové kurzy s využitím hlavních světových měn jako mostu (pivotu).
• Inteligentní záložní mechanismus: Pokud nejsou data pro požadované datum k dispozici (např. z důvodu uzavření trhu o víkendech nebo svátcích), systém automaticky vyhledá nejnovější platný kurz v rámci posuvného 8denního okna .
• Vysoká přesnost: Aby se zabránilo chybám zaokrouhlování ve finančních výpočtech, směnné kurzy se ukládají a zpracovávají s až 18 desetinnými místy .

Koncové body

Koncový bod podporovaných symbolů

https://currencyrateapi.com/api/codes

Tento koncový bod vrací úplný seznam všech podporovaných měn. Můžete také použít alias /api/currencies.

Seznam všech podporovaných měn v čitelném provedení je k dispozici také na naší stránce Podporované měny .

Základní měny: Ve výchozím nastavení některé další koncové body (například /latest a /{YYYY-MM-DD}) vracejí omezenou sadu hlavních globálních měn, aby se minimalizoval provoz. Tyto „základní“ měny jsou:

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

Odpověď 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"
        },
        [...]
    }
}

Objekty odpovědi:

Koncový bod nejnovějších sazeb

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

Parametry požadavku:

Odpověď API:

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

Objekty odpovědi:

Koncový bod historických sazeb

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

Alternativní formát: /api/history?date=2025-08-25...

Parametry požadavku:

Odpověď API:

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

Objekty odpovědi:

Ukázkový kó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 (načtení)

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