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 :

Option 1 : En-tête d'autorisation (Recommandé)

En-tête d'autorisation (Obligatoire)

Authorization: Bearer YOUR_API_KEY

Option 2 : Paramètre de requête

Passez votre clé API en tant que paramètre de requête :

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

⚠ Note de sécurité : Les clés API dans les URL peuvent être enregistrées dans les journaux d'accès du serveur et peuvent fuir via les en-têtes HTTP Referrer. Pour l'utilisation en production, nous recommandons la méthode de l'en-tête Authorization. Le paramètre de requête est fourni pour un test rapide et des intégrations simples.

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

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

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.

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.