Iniziare
L'API di Finexly fornisce tassi di cambio in tempo reale e storici per oltre 170 valute. Iniziare è facile:
- Registrati per un account gratuito
- Ottieni la tua chiave di accesso API dalla dashboard
- Effettua la tua prima richiesta API
URL di base
https://api.finexly.com/v1/
Autenticazione
Tutte le richieste API richiedono l'autenticazione tramite token Bearer. Includi la tua chiave API nell'intestazione Authorization:
Opzione 1: Intestazione di autorizzazione (Consigliato)
Intestazione di autorizzazione (Obbligatoria)
Authorization: Bearer YOUR_API_KEY
Opzione 2: Parametro di Query
Passa la tua chiave API come parametro di query:
GET https://api.finexly.com/v1/rate?from=USD&to=EUR&api_key=YOUR_API_KEY
⚠ Nota di sicurezza: Le chiavi API negli URL possono essere registrate nei log di accesso del server e possono trapelare tramite gli header HTTP Referrer. Per l'uso in produzione, raccomandiamo il metodo dell'header Authorization. Il parametro di query è fornito come comodità per test rapidi e integrazioni semplici.
Limitazione della frequenza: Controlla le intestazioni di risposta per il tuo utilizzo attuale:
X-RateLimit-Limit,
X-RateLimit-Used,
X-RateLimit-Units
Endpoint API
/v1/currencies
Ottieni un elenco di tutti i codici valuta supportati.
Parametri
| Nome | Tipo | Obbligatorio | Descrizione |
|---|
Esempio
GET https://api.finexly.com/v1/currencies
// Risposta
[
"AED",
"ANG",
"AUD",
"EUR",
"GBP",
"USD"
]
/v1/rate
Ottieni il tasso di cambio per una coppia di valute specifica.
Parametri
| Nome | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| from | string | Sì | Codice valuta base (maiuscolo) |
| to | string | Sì | Codice valuta quotata (maiuscolo) |
Esempio
GET https://api.finexly.com/v1/rate?from=USD&to=EUR
// Risposta
{
"pair": "USD_EUR",
"rate": 0.9215
}
/v1/convert
Ottieni i tassi di cambio per più coppie di valute in una singola richiesta.
Parametri
| Nome | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| q | string | Sì | Coppie separate da virgola nel formato BASE_QUOTATA |
Esempio
GET https://api.finexly.com/v1/convert?q=USD_EUR,USD_GBP
// Risposta
{
"USD_EUR": {
"rate": 0.9215
},
"USD_GBP": {
"rate": 0.7892
}
}
/v1/convert-amount
Converti un importo specifico da una valuta all'altra.
Parametri
| Nome | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| from | string | Sì | Codice valuta di origine (maiuscolo) |
| to | string | Sì | Codice valuta di destinazione (maiuscolo) |
| amount | number | Sì | Importo da convertire |
Esempio
GET https://api.finexly.com/v1/convert-amount?from=USD&to=EUR&amount=100
// Risposta
{
"pair": "USD_EUR",
"rate": 0.9215,
"amount": 100,
"result": 92.15
}
Esempi di codice
# Using Authorization header (recommended)
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://api.finexly.com/v1/rate?from=USD&to=EUR"
# Using query parameter
curl "https://api.finexly.com/v1/rate?from=USD&to=EUR&api_key=YOUR_API_KEY"
# Get multiple rates
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://api.finexly.com/v1/convert?q=USD_EUR,USD_GBP"
# Convert amount
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://api.finexly.com/v1/convert-amount?from=USD&to=EUR&amount=100"
<?php
$apiKey = 'YOUR_API_KEY';
// Using cURL
$ch = curl_init();
curl_setopt_array($ch, [
CURLOPT_URL => 'https://api.finexly.com/v1/rate?from=USD&to=EUR',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer ' . $apiKey,
],
]);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);
echo "USD/EUR Rate: " . $data['rate'];
const apiKey = 'YOUR_API_KEY';
// Get single rate
const response = await fetch('https://api.finexly.com/v1/rate?from=USD&to=EUR', {
headers: {
'Authorization': `Bearer ${apiKey}`
}
});
const data = await response.json();
console.log(`USD/EUR Rate: ${data.rate}`);
// Convert amount
const convertResponse = await fetch(
'https://api.finexly.com/v1/convert-amount?from=USD&to=EUR&amount=100',
{ headers: { 'Authorization': `Bearer ${apiKey}` } }
);
const result = await convertResponse.json();
console.log(`100 USD = ${result.result} EUR`);
import requests
api_key = 'YOUR_API_KEY'
headers = {'Authorization': f'Bearer {api_key}'}
# Get single rate
response = requests.get(
'https://api.finexly.com/v1/rate',
params={'from': 'USD', 'to': 'EUR'},
headers=headers
)
data = response.json()
print(f"USD/EUR Rate: {data['rate']}")
# Convert amount
response = requests.get(
'https://api.finexly.com/v1/convert-amount',
params={'from': 'USD', 'to': 'EUR', 'amount': 100},
headers=headers
)
result = response.json()
print(f"100 USD = {result['result']} EUR")
Codici di errore
| Codice | Tipo | Descrizione |
|---|---|---|
| 400 | BAD_REQUEST | Parametri di richiesta non validi o campi obbligatori mancanti. |
| 401 | UNAUTHORIZED | Token API mancante o non valido. |
| 403 | FORBIDDEN | Accesso negato. Il tuo account potrebbe essere inattivo. |
| 413 | PAYLOAD_TOO_LARGE | Il payload della richiesta supera la dimensione massima consentita. |
| 429 | RATE_LIMIT_EXCEEDED | Hai superato il limite di richieste. Controlla gli header X-RateLimit. |
| 500 | INTERNAL_ERROR | Si è verificato un errore interno del server. Riprova. |
Tutorials & Guides
Learn how to integrate Finexly with your favorite programming languages and frameworks.
JavaScript Integration Tutorial
Step-by-step guide to integrating Finexly API with JavaScript and Node.js.
Python Integration Tutorial
Complete guide to using Finexly API with Python and popular libraries.
Developer Guide
Comprehensive guide to free currency API features and best practices.
Historical Rates Guide
Learn how to retrieve and work with historical exchange rate data.