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.

Connecteurs IA (MCP)

Finexly utilise le Protocole de Contexte Modèle, permettant à un assistant IA de lire directement les taux au lieu de les recevoir. Il s'agit d'un canal distinct de l'API REST ci-dessous : il s'authentifie avec OAuth plutôt qu'avec une clé API, et il est en lecture seule.

URL du serveur

https://mcp.finexly.com

Outils qu'il expose

Nom Description
get_exchange_rate Le taux actuel entre deux devises.
convert_amount Convertir un montant, en utilisant le dollar américain comme référence si nécessaire.
list_currencies Chaque devise que nous couvrons.
get_historical_rates Taux quotidiens sur une période, pour des paires collectées directement.

Autorisation

Le connecteur exécute un flux de code d'autorisation OAuth 2.1 avec PKCE. La découverte se fait aux URL ci-dessous ; la seule portée est fx:read, et il n'y a pas de portée qui accorde l'accès au compte.

  • https://finexly.com/.well-known/oauth-authorization-server
  • https://finexly.com/oauth/authorize
  • https://finexly.com/oauth/token
  • https://finexly.com/oauth/jwks
Guide de configuration et plan des allocations →

Tutorials & Guides

Learn how to integrate Finexly with your favorite programming languages and frameworks.