CurrencyRateAPI

Strumento di avvio rapido

Vuoi testare l'API senza dover consultare l'intera documentazione? Accedi al Pannello di controllo, dove troverai lo Strumento di avvio rapido, un modo semplice per provare tutti gli endpoint disponibili con un solo clic.

Clicca sul pulsante qui sotto per registrarti gratuitamente e iniziare a utilizzare lo strumento di avvio rapido.

Iniziare

Termini e concetti chiave di cui avrai bisogno per iniziare a lavorare con Currency Rate API:

Risposta API

I tassi di cambio forniti da CurrencyRateAPI sono di default in euro. Tutti i dati vengono restituiti in formato JSON standard e possono essere facilmente analizzati utilizzando qualsiasi linguaggio di programmazione.

Esempio di risposta:
Di seguito è riportato un esempio di risposta API contenente una serie di valute mondiali comuni, tutte relative alla valuta EUR e con il timestamp in cui sono state ricevute.

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

Come mostrato sopra, la risposta API per i tassi di cambio in tempo reale include diversi campi chiave:

• success indica se la richiesta ha avuto successo.
• base restituisce il codice di 3 lettere della valuta di base utilizzata per questa richiesta.
• date restituisce la data effettiva per la quale vengono forniti i tassi di cambio (formato AAAA-MM-GG).
• rates contiene l'elenco delle valute richieste e i relativi tassi di cambio correnti.
• last_update_unix mostra il timestamp (in formato Unix) degli ultimi dati disponibili nel sistema.

Endpoint disponibili

CurrencyRateAPI include diversi endpoint API, ognuno dei quali offre funzionalità specifiche. La disponibilità di alcuni endpoint dipende dal piano di abbonamento.

• Punto finale dell'elenco delle valute. Questo endpoint restituisce l'elenco completo di tutte le valute supportate. /api/codes (Alternativa: /api/currencies)
• Punto di arrivo delle tariffe più recenti. Questo endpoint restituisce dati sul tasso di cambio in tempo reale per tutte le valute supportate. /api/latest
• Punto finale dei tassi storici. Questo endpoint restituisce i dati storici sul tasso di cambio per una data specifica. /api/YYYY-MM-DD (Alternativa: /api/history?date=YYYY-MM-DD). I dati storici sono disponibili a partire dal 4 gennaio 1999.

Metodologia del tasso di cambio

Per garantire l'accuratezza e la coerenza dei dati, CurrencyRateAPI segue una metodologia rigorosa per la gestione e la fornitura dei tassi di cambio:

• Tariffe medie di mercato: Per impostazione predefinita, l'API restituisce i tassi mid . Questi rappresentano la media aritmetica tra i prezzi di acquisto ( bid ) e di vendita ( ask ) di mercato, oppure i tassi di riferimento ufficiali delle banche centrali.
• Finalizzazione di fine giornata (EOD): Le tariffe storiche fornite dall'API sono aggiornate alla fine della giornata in UTC (Tempo Universale Coordinato).
• Calcolo del tasso incrociato: Per le coppie di valute che non sono direttamente disponibili dalle nostre fonti, il sistema calcola automaticamente tassi incrociati estremamente accurati utilizzando le principali valute globali come ponte (pivot).
• Meccanismo di fallback intelligente: Se i dati per una data richiesta non sono disponibili (ad esempio a causa della chiusura del mercato nei fine settimana o nei giorni festivi), il sistema cerca automaticamente il tasso valido più recente all'interno di una finestra mobile di 8 giorni .
• Alta precisione: Per evitare errori di arrotondamento nei calcoli finanziari, i tassi di cambio vengono memorizzati ed elaborati con un massimo di 18 cifre decimali .

Punti finali

Endpoint dei simboli supportati

https://currencyrateapi.com/api/codes

Questo endpoint restituisce l'elenco completo di tutte le valute supportate. Puoi anche utilizzare l'alias /api/currencies.

Un elenco leggibile di tutte le valute supportate è disponibile anche nella nostra pagina Valute supportate .

Valute di base: Per impostazione predefinita, alcuni altri endpoint (come /latest e /{YYYY-MM-DD}) restituiscono un set limitato delle principali valute globali per ridurre al minimo il traffico. Queste valute "di base" sono:

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

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

Oggetti di risposta:

Ultime tariffe Endpoint

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

Parametri di richiesta:

Risposta API:

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

Oggetti di risposta:

Punto finale dei tassi storici

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

Formato alternativo: /api/history?date=2025-08-25...

Parametri di richiesta:

Risposta API:

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

Oggetti di risposta:

Codice di esempio

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

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