CurrencyRateAPI

Instrument de lansare rapidă

Trebuie să testați API-ul fără a consulta întreaga documentație? Accesați Panoul de control, unde veți găsi Instrumentul de lansare rapidă — o modalitate simplă de a testa toate endpoint-urile disponibile cu un singur clic.

Faceți clic pe butonul de mai jos pentru a vă înregistra gratuit și a începe să utilizați Instrumentul de lansare rapidă.

Noțiuni de bază

Termeni și concepte cheie de care veți avea nevoie pentru a începe să lucrați cu API-ul Currency Rate:

Răspuns API

Cursurile de schimb valutar furnizate de CurrencyRateAPI sunt implicit în euro. Toate datele sunt returnate în format JSON standard și pot fi ușor analizate folosind orice limbaj de programare.

Exemplu de răspuns:
Mai jos veți găsi un exemplu de răspuns API care conține o gamă de valute comune la nivel mondial, toate relative la moneda EUR și cu un timestamp în care au fost primite.

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

După cum se arată mai sus, răspunsul API pentru cursurile de schimb în timp real include mai multe câmpuri cheie:

• success indică dacă solicitarea a avut succes.
• base returnează codul de 3 litere al monedei de bază utilizate pentru această solicitare.
• date returnează data efectivă pentru care sunt furnizate cursurile de schimb (format AAAA-LL-ZZ).
• rates conține lista valutelor solicitate și cursurile lor de schimb actuale.
• last_update_unix afișează marca temporală (în format Unix) a celor mai recente date disponibile în sistem.

Puncte finale disponibile

CurrencyRateAPI include mai multe endpoint-uri API, fiecare oferind funcționalități specifice. Disponibilitatea anumitor endpoint-uri depinde de planul dvs. de abonament.

• Punctul final al listei de valute. Acest punct final returnează lista completă a tuturor monedelor acceptate. /api/codes (Alternativă: /api/currencies)
• Punctul final al celor mai recente rate. Acest punct final returnează date despre cursul de schimb în timp real pentru toate monedele acceptate. /api/latest
• Punctul final al ratelor istorice. Acest punct final returnează date istorice despre cursul de schimb valutar pentru o anumită dată. /api/YYYY-MM-DD (Alternativă: /api/history?date=YYYY-MM-DD). Datele istorice sunt disponibile începând cu 4 ianuarie 1999.

Metodologia cursului de schimb

Pentru a asigura acuratețea și consecvența datelor, CurrencyRateAPI urmează o metodologie strictă pentru gestionarea și furnizarea cursurilor de schimb valutar:

• Tarife medii de piață: În mod implicit, API-ul returnează rate mid . Acestea reprezintă media aritmetică dintre prețurile de cumpărare ( bid ) și de vânzare ( ask ) de pe piață sau ratele de referință oficiale de la băncile centrale.
• Finalizare la sfârșitul zilei (EOD): Ratele istorice furnizate de API sunt finalizate la sfârșitul zilei în UTC (Timp Universal Coordonat).
• Calculul ratei încrucișate: Pentru perechile valutare care nu sunt disponibile direct din sursele noastre, sistemul calculează automat rate de schimb extrem de precise, utilizând principalele valute globale ca punct de reper (pivot).
• Mecanism inteligent de rezervă: Dacă datele pentru o dată solicitată nu sunt disponibile (de exemplu, din cauza închiderii pieței în weekenduri sau de sărbători), sistemul caută automat cel mai recent curs valid într-o fereastră glisantă de 8 zile .
• Precizie ridicată: Pentru a preveni erorile de rotunjire în calculele financiare, cursurile de schimb valutar sunt stocate și procesate cu până la 18 zecimale .

Puncte finale

Simboluri acceptate - Punct final

https://currencyrateapi.com/api/codes

Acest punct final returnează lista completă a tuturor monedelor acceptate. De asemenea, puteți utiliza aliasul /api/currencies.

O listă ușor de citit de către om cu toate monedele acceptate este disponibilă și pe pagina noastră Monede acceptate .

Monede de bază: În mod implicit, alte endpoint-uri (cum ar fi /latest și /{YYYY-MM-DD}) returnează un set limitat de valute globale majore pentru a minimiza traficul. Aceste valute „de bază” sunt:

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

Răspuns 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"
        },
        [...]
    }
}

Obiecte de răspuns:

Punct final pentru cele mai recente tarife

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

Parametrii solicitării:

Răspuns API:

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

Obiecte de răspuns:

Punctul final al ratelor istorice

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

Format alternativ: /api/history?date=2025-08-25...

Parametrii solicitării:

Răspuns API:

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

Obiecte de răspuns:

Cod exemplu

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

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