Documentation
RatesAPI est une API JSON permettant d'accéder aux taux de change en temps réel, mis à jour toutes les heures. Aucune authentification requise.
Base URL
Format de réponse
{
"success": true, // false si erreur
"...": "..." // données spécifiques à l'endpoint
}
Codes d'erreur
Toutes les réponses incluent un champ
success. En cas d'erreur, le champ
error
est présent avec un message et un code HTTP.
success: true
Format d'une réponse d'erreur
{
"success": false,
"error": "Devise source introuvable: XYZ",
"code": 404
}
/api/v1/latest
Récupère les derniers taux de change. Par défaut, retourne tous les taux par rapport à l'USD.
Paramètres
| Paramètre | Type | Statut | Défaut | Description |
|---|---|---|---|---|
| base | String | Optionnel | USD | Devise de base (ex: EUR, GBP) |
| currencies | String | Optionnel | Toutes | Liste séparée par virgules (ex: EUR,GBP,XOF) |
| amount | Number | Optionnel | 1 | Montant à convertir depuis la base |
| places | Integer | Optionnel | 2 | Décimales dans le résultat (0–8) |
cURL
curl "https://rates.sandrindossou.com/api/v1/latest?base=EUR¤cies=USD,XOF,NGN"
Exemple de réponse
{
"success": true,
"base": "EUR",
"rates": {
"USD": 1.08,
"XOF": 655.96,
"NGN": 1728.32
}
}
Tester
/api/v1/convert
Convertit un montant d'une devise source vers une devise cible.
Paramètres
| Paramètre | Type | Statut | Défaut | Description |
|---|---|---|---|---|
| from | String | Optionnel | USD | Devise source |
| to | String | Optionnel | EUR | Devise cible |
| amount | Number | Optionnel | 1 | Montant à convertir |
cURL
curl "https://rates.sandrindossou.com/api/v1/convert?from=USD&to=XOF&amount=100"
Exemple de réponse
{
"success": true,
"query": {
"from": "USD",
"to": "XOF",
"amount": 100
},
"result": 60550.00
}
Tester
/api/v1/currencies
Retourne la liste complète des devises supportées avec symboles, noms et informations de formatage. Aucun paramètre requis.
cURL
curl "https://rates.sandrindossou.com/api/v1/currencies"
Exemple de réponse
{
"success": true,
"currencies": [
{
"code": "XOF",
"name": "CFA Franc BCEAO",
"symbol": "CFA",
"symbol_native": "CFA",
"decimal_digits": 0
},
// ... 170+ devises
]
}
Tester
Simulateur de conversion
Convertissez un montant vers plusieurs devises en une seule requête. Résultats affichés sous forme de tableau comparatif.
Conversion multi-devises