Commencer

L'API Finexly fournit des taux de change en temps réel et historiques pour plus de 170 devises. Commencer est facile :

  1. Inscrivez-vous pour un compte gratuit
  2. Obtenez votre clé d'accès API depuis le tableau de bord
  3. Effectuez votre première requête API

URL de base

https://api.finexly.com/v1/

Authentification

Toutes les requêtes API nécessitent une authentification via un jeton Bearer. Incluez votre clé API dans l'en-tête Authorization :

En-tête d'autorisation (Obligatoire)

Authorization: Bearer YOUR_API_KEY

Limitation de taux : Vérifiez les en-têtes de réponse pour votre utilisation actuelle : X-RateLimit-Limit, X-RateLimit-Used, X-RateLimit-Units

Points de terminaison API

GET /v1/currencies

Obtenir la liste de tous les codes de devises pris en charge.

Paramètres

Nom Type Obligatoire Description

Exemple

GET https://api.finexly.com/v1/currencies

// Réponse
[
    "AED",
    "ANG",
    "AUD",
    "EUR",
    "GBP",
    "USD"
]
GET /v1/rate

Obtenir le taux de change pour une paire de devises spécifique.

Paramètres

Nom Type Obligatoire Description
from string Oui Code de devise de base (majuscules)
to string Oui Code de devise de cotation (majuscules)

Exemple

GET https://api.finexly.com/v1/rate?from=USD&to=EUR

// Réponse
{
    "pair": "USD_EUR",
    "rate": 0.9215
}
GET /v1/convert

Obtenir les taux de change pour plusieurs paires de devises en une seule requête.

Paramètres

Nom Type Obligatoire Description
q string Oui Paires séparées par des virgules au format BASE_COTATION

Exemple

GET https://api.finexly.com/v1/convert?q=USD_EUR,USD_GBP

// Réponse
{
    "USD_EUR": {
        "rate": 0.9215
    },
    "USD_GBP": {
        "rate": 0.7892
    }
}
GET /v1/convert-amount

Convertir un montant spécifique d'une devise à une autre.

Paramètres

Nom Type Obligatoire Description
from string Oui Code de devise source (majuscules)
to string Oui Code de devise cible (majuscules)
amount number Oui Montant à convertir

Exemple

GET https://api.finexly.com/v1/convert-amount?from=USD&to=EUR&amount=100

// Réponse
{
    "pair": "USD_EUR",
    "rate": 0.9215,
    "amount": 100,
    "result": 92.15
}

Exemples de code

# 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")

Codes d'erreur

Code Type Description
400 BAD_REQUEST Paramètres de requête invalides ou champs requis manquants.
401 UNAUTHORIZED Token API manquant ou invalide.
403 FORBIDDEN Accès refusé. Votre compte est peut-être inactif.
413 PAYLOAD_TOO_LARGE La taille de la requête dépasse la taille maximale autorisée.
429 RATE_LIMIT_EXCEEDED Vous avez dépassé votre limite de taux. Vérifiez les en-têtes X-RateLimit.
500 INTERNAL_ERROR Une erreur interne du serveur s'est produite. Veuillez réessayer.