C
CurrencyRest

Endpoints

Tous les endpoints sont en lecture seule (GET), renvoient du JSON et sont versionnés sous /v1. Base : https://api.currencyrest.com/v1

Le paramètre source

Sans source, le taux provient de la source la mieux classée disponible pour la paire (mode par défaut), avec calcul de taux croisé via USD/EUR si besoin. Avec source, le taux provient strictement de cette source — jamais de repli silencieux. Sources : ecb, boe, fed, boj, fixed, binance, google-finance, tradingview, google-search.

GET/convert

Convertir un montant

Convertit un montant d’une devise vers une autre.

fromstring · requiredDevise source (ex. EUR)
tostring · requiredDevise cible (ex. USD)
amountnumber · requiredMontant à convertir
sourcestringSource spécifique (optionnel)
Requestbash
curl "https://api.currencyrest.com/v1/convert?from=EUR&to=USD&amount=100" \
  -H "X-API-Key: your_api_key"
200 OKjson
{
  "from": "EUR",
  "to": "USD",
  "amount": 100,
  "result": 116.07,
  "rate": 1.1607,
  "source": "ecb",
  "timestamp": "2026-06-16T00:00:00.000Z"
}
GET/rates

Tous les taux pour une base

Renvoie tous les taux disponibles pour une devise de base.

basestringDevise de base (défaut USD)
sourcestringFiltrer sur une source
200 OKjson
{
  "base": "EUR",
  "source": "default",
  "timestamp": "2026-06-16T09:00:00.000Z",
  "rates": { "USD": 1.1607, "GBP": 0.8648, "JPY": 186.1, "EUR": 1 }
}
GET/rates/pair

Taux d’une paire

fromstring · requiredDevise source
tostring · requiredDevise cible
sourcestringSource spécifique
200 OKjson
{ "from": "EUR", "to": "GBP", "rate": 0.86483, "source": "ecb", "timestamp": "2026-06-15T00:00:00.000Z" }
GET/rates/sources

Sources d’une paire

Liste les sources qui ont un taux pour la paire.

200 OKjson
{ "from": "EUR", "to": "USD", "sources": ["ecb", "google-finance", "tradingview"] }
GET/historical

Historique d’une paire

fromstring · requiredDevise source
tostring · requiredDevise cible
sourcestringFiltrer sur une source
startDateISO dateDébut de période
endDateISO dateFin de période
limitnumberNb de points (max 5000)
200 OKjson
{
  "from": "EUR",
  "to": "USD",
  "source": "all",
  "count": 2,
  "points": [
    { "rate": 1.1607, "source": "ecb", "timestamp": "2026-06-15T00:00:00.000Z" },
    { "rate": 1.1612, "source": "tradingview", "timestamp": "2026-06-14T17:00:00.000Z" }
  ]
}
GET/status

Statut des sources

Santé en direct de chaque source (operational / degraded / outage). Public, sans clé.

200 OKjson
{
  "overall": "operational",
  "sources": [
    { "source": "ecb", "status": "operational", "latencyMs": 95, "lastCheckedAt": "..." },
    { "source": "binance", "status": "operational", "latencyMs": 290, "lastCheckedAt": "..." }
  ],
  "services": []
}

Prochaines étapes