Iniziare

L'API di Finexly fornisce tassi di cambio in tempo reale e storici per oltre 170 valute. Iniziare è facile:

  1. Registrati per un account gratuito
  2. Ottieni la tua chiave di accesso API dalla dashboard
  3. 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:

Intestazione di autorizzazione (Obbligatoria)

Authorization: Bearer YOUR_API_KEY

Limitazione della frequenza: Controlla le intestazioni di risposta per il tuo utilizzo attuale: X-RateLimit-Limit, X-RateLimit-Used, X-RateLimit-Units

Endpoint API

GET /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"
]
GET /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
}
GET /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
    }
}
GET /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

# Get single rate
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.finexly.com/v1/rate?from=USD&to=EUR"

# Get multiple rates
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.finexly.com/v1/convert?q=USD_EUR,USD_GBP,BTC_USD"

# 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.