Live-Rates.com est un service Web et API Rest JSON / XML en temps réel pour le forex, les matières premières et les indices. Une API Streaming est également disponible pour les abonnés à partir de 2019.
Les tarifs sont mis à jour toutes les secondes .
Obtenez les derniers taux de référence de change au format JSON.
GET /rates
Host: live-rates.com
Obtenez les derniers taux de référence de change au format XML.
GET /rates?rate_format=xml
Host: live-rates.com
(nécessite une authentification)
Obtenez les paires de devises, matières premières et indices disponibles ainsi que la date de leur dernière mise à jour
GET /api/rates?key=YOUR_KEY
Host: live-rates.com
Obtenez les derniers taux de référence de change pour les paramètres demandés, au format JSON.
GET /api/price?rate=EUR_USD,EUR_GBP&key=YOUR_KEY
Host: live-rates.com
(nécessite une authentification)
Avec l'API de streaming, il n'est plus nécessaire de demander de nouvelles données chaque seconde. Lorsque les données mises à jour sont récupérées par le serveur principal, elles sont automatiquement transmises au client via la technologie Web-socket (socket.io).
Le serveur DNS central (wss.live-rates.com) vous connecte au centre de données préféré en fonction de votre emplacement et de la disponibilité du serveur. Les serveurs locaux disponibles sont :
Emplacement | Adresse de prise | (*) Adresse du socket V3 |
---|---|---|
Serveur de routeur | wss.live-rates.com | wss3.live-rates.com |
Europe | eu-wss.live-rates.com | eu-wss3.live-rates.com |
NOUS | us-wss.live-rates.com | us-wss3.live-rates.com |
Asie | as-wss.live-rates.com | as-wss3.live-rates.com |
(*) Requis pour la nouvelle version client de socketio (3.xx)
Consultez les exemples d'API Web-socket pour comprendre comment vous pouvez l'intégrer et l'utiliser :
Toutes les API - Web-Service / Rest API / Streaming API - génèrent des données avec la même structure. Tous les champs sont envoyés au format chaîne :
{
Currency: "EUR/USD" //Description of the Instrument
Rate: "1.13625" //Same as BID (Deprecated)
Bid: "1.13625" //Bid Value of the Currency / Instrument
Ask: "1.13638" //Ask Value of the Currency / Instrument
High: "1.14081" //24H High of the Currency / Instrument
Low: "1.13527" //24H Low of the Currency / Instrument
Open: "1.13725" //Opening Value of the Daily Session / Previous Day if Market is Active
Close: "1.13625" //Closing Value of the Daily Session / Previous Day if Market is Active
Timestamp: "1551477238763" //Timestamp of the Last Update
}
...
(nécessite une authentification)
Live-Rates fournit des données historiques pour un nombre limité d'instruments (+-170). Pour le moment, seules les devises Forex, les métaux et les crypto-monnaies sont disponibles. Tous les points de terminaison nécessitent une authentification.
Cela affichera tous les instruments disponibles
GET /historical/list?key=YOUR_KEY
Host: live-rates.com
Ce point de terminaison fournira le prix de clôture pour le jour requis (23:59:59 heure UTC).
Vous pouvez fournir les symboles de paramètres facultatifs si vous n’avez besoin que de paires spécifiques.
GET /historical?base=EUR&date=YYYY-MM-DD&symbols=USD&key=YOUR_KEY
Host: live-rates.com
Ce point de terminaison fournira les tarifs pour une période passée donnée qui ne peut pas dépasser 30 jours .
Vous pouvez fournir les symboles de paramètres facultatifs si vous n’avez besoin que de paires spécifiques.
GET /historical/series?base=EUR&start=YYYY-MM-DD&end=YYYY-MM-DD&symbols=USD&key=YOUR_KEY
Host: live-rates.com
Pour des raisons évidentes, Live-Rates ne fournit pas directement tous les milliers de combinaisons possibles de taux croisés. Tous nos tarifs disponibles proviennent directement de fournisseurs disposant d'une réelle liquidité. Si vous avez besoin d'obtenir/calculer un taux non disponible directement, vous pouvez le convertir en changeant la devise de base.
Exemple : MYR/CNY, MYR/GBP ou tout autre taux croisé avec la devise de base MYR ne sont pas fournis. Toutefois, cela ne signifie pas que vous ne pouvez pas les obtenir. Dans ce cas/exemple, vous pouvez utiliser directement l'USD/MYR, puis l'USD/XXX souhaité.
{
"currency" : "USD/MYR" , "rate" : "4.14611" ,
"currency" : "USD/CNY" , "rate" : "6.8421"
}
// 6.84/4.15 = 1.65 MYR/CNY
Live-Rates dispose actuellement de plusieurs serveurs dans 3 centres de données :
Les demandes adressées à live-rates.com sont transmises et résolues par notre serveur DNS central en Europe.
Si vous contournez le serveur DNS et vous connectez directement à un centre de données spécifique, la connexion sera plus rapide. Cependant, en cas de problème avec le serveur, vous recevrez un 502 ou un 521 au lieu d'une réponse de réussite du serveur alternatif.
Nous autorisons jusqu'à 3 hits/heure/ip pour les requêtes non authentifiées. Si vous devez faire des requêtes API ou obtenir des tarifs en direct mis à jour chaque seconde, vous devrez souscrire une licence et inclure dans vos requêtes le paramètre suivant :
GET /rates?key=Your key
Host: live-rates.com
Nous limitons l'accès aux agresseurs. Si votre licence accède plus d'une fois par seconde sur une moyenne de 10 minutes, elle sera temporairement verrouillée pendant 10 minutes. Vous recevrez 503 Service Unavailable
pendant cette période.