L’API de trading crypto de Volity offre aux développeurs un accès programmatique aux données de marché, à la gestion d’ordres et à la gestion des positions. Les points REST gèrent l’état du compte, la saisie d’ordres et les données historiques. Les flux WebSocket délivrent prix en temps réel et événements de trade. Environnement sandbox, prise en charge des Expert Advisors MQL et limites de débit VIP complètent l’offre.
Ce que vous offre l’API de trading crypto
Trois schémas d’intégration, selon le niveau de personnalisation de votre système :
1. Expert Advisors MQL (EA). La voie la plus simple. Écrivez ou achetez un EA en MQL4 ou MQL5, déposez-le dans Volity MT, et l’EA s’exécute en votre nom en utilisant le même moteur d’exécution que le trading manuel. Les EA tournent sur l’infrastructure de Volity avec le même taux d’exécution de 99,6 % en moins d’une seconde.
2. API REST. Intégration serveur à serveur. Interrogez les soldes du compte, les positions ouvertes, passez des ordres, récupérez l’historique des trades. HTTP/JSON standard. Authentification par clé API émise dans le portail de compte. Convient aux stratégies algorithmiques construites en Python, Node.js, Go ou tout langage gérant HTTP.
3. Flux WebSocket. Données de marché et événements de compte en temps réel. Abonnez-vous aux flux de ticks de prix pour tout instrument, écoutez les exécutions d’ordres, les mises à jour de positions, les changements de solde. Livraison push à faible latence. Combiné avec REST pour une couverture système complète.
Catégories de points
Points compte (REST) : GET /account, solde, équité, niveau de marge, exposition. GET /positions, positions ouvertes avec P&L et exigence de marge. GET /orders, ordres ouverts et en attente. GET /history, trades et ordres historiques.
Points données de marché (REST) : GET /instruments, liste complète des instruments avec spécifications. GET /quotes/{symbol}, bid/ask actuels. GET /candles/{symbol}, historique OHLCV à toute unité de temps.
Points de trading (REST) : POST /orders, passez des ordres au marché, à cours limité, stop ou OCO. PUT /orders/{id}, modifiez un ordre ouvert. DELETE /orders/{id}, annulez un ordre. POST /positions/{id}/close, fermez une position spécifique.
Canaux WebSocket : quotes:{symbol}, streaming bid/ask en temps réel. trades:{symbol}, ticks de trades publics. account, mises à jour de l’état de votre compte. positions, mises à jour de vos positions. orders, mises à jour de vos ordres.
Authentification
Les clés API sont émises depuis le portail de compte sous Paramètres → Accès API. Chaque clé a :
- Permissions : lecture seule, trading activé, ou accès complet incluant les retraits
- Liste d’IP autorisées : restreignez la clé à des IP sources spécifiques
- Palier de limite de débit : Standard (60 req/min) ou VIP (600 req/min)
- Bascule sandbox : testez contre capital de démo avant de passer en live
Les clés sont révocables à tout moment. Bonne pratique : clés séparées par environnement (une pour le backtesting, une pour le live, une pour la surveillance).
Exemples de code
Python REST : passer un ordre au marché
« `python import requests import os
headers = { « Authorization »: f »Bearer {os.environ[‘VOLITY_API_KEY’]} », « Content-Type »: « application/json » } order = { « symbol »: « BTCUSD », « side »: « buy », « type »: « market », « size »: 0.01, « stop_loss »: 65000, « take_profit »: 75000 } r = requests.post(« https://api.volity.io/v1/orders », json=order, headers=headers) print(r.json()) « `
Node.js WebSocket : s’abonner aux ticks BTC
« `javascript import WebSocket from ‘ws’;
const ws = new WebSocket(‘wss://stream.volity.io/v1?api_key=’ + process.env.VOLITY_API_KEY);
ws.on(‘open’, () => { ws.send(JSON.stringify({ subscribe: [‘quotes:BTCUSD’, ‘quotes:ETHUSD’] })); });
ws.on(‘message’, (data) => { const tick = JSON.parse(data); console.log(${tick.symbol}: bid ${tick.bid} ask ${tick.ask}); }); « `
Limites de débit
| Palier | REST req/min | Connexions WebSocket | Ordres concurrents |
|---|---|---|---|
| Standard | 60 | 5 | 50 |
| VIP | 600 | 25 | 500 |
Le palier VIP se débloque à 50 000 € de solde de compte. La marge de manœuvre sur les limites de débit est l’une des raisons pratiques pour lesquelles les stratégies haute fréquence passent tôt au VIP.
Environnement sandbox
Chaque clé API peut basculer entre sandbox (capital de démo) et live (capital réel). Le sandbox est identique au live sur tous les aspects sauf les fonds ; les ordres s’exécutent contre solde virtuel. Utilisez-le pour :
- Tester de nouvelles stratégies avant déploiement en live
- Valider la gestion d’erreur et la logique de reconnexion
- Intégrer de nouveaux développeurs sans exposer les clés live
- Exécuter des suites de tests automatisés dans les pipelines CI/CD
La bascule est un seul paramètre API ou une URL de base distincte (sandbox.api.volity.io).
Cas d’usage courants de l’API de trading crypto
- Trading algorithmique. Stratégies personnalisées en Python ou C++ que le framework EA MQL ne peut pas exprimer
- Tableaux de bord de portefeuille. Agréger les positions sur Volity plus d’autres comptes dans une vue unique
- Surcouches de surveillance du risque. Vérifier en continu drawdown, concentration d’exposition, utilisation de l’effet de levier ; alerter sur dépassement de seuil
- Infrastructure de backtesting. Tirer les données historiques, rejouer contre votre stratégie avec spreads et slippage réalistes
- Outillage de reporting et de conformité. Exporter le P&L quotidien, générer des rapports par trade pour besoins fiscaux ou d’audit
- Systèmes de copy-trading. Refléter les trades d’un compte maître vers des comptes suiveurs (sous réserve des exigences réglementaires)
Latence et fiabilité
L’API de Volity tourne depuis des centres de données européens avec présence edge mondiale. Latences médianes typiques :
- Requête REST depuis l’UE : 30 à 80 ms
- Requête REST depuis la côte Est des États-Unis : 90 à 130 ms
- Livraison de tick WebSocket : moins de 50 ms entre mise à jour de cotation et client
- SLA de disponibilité : 99,9 % sur Standard, 99,99 % sur VIP
Pour les stratégies sensibles à la latence, les comptes de palier VIP peuvent demander des cross-connects dédiés vers le cœur de trading.
Bonnes pratiques de sécurité
- Ne committez jamais les clés API dans git. Utilisez des variables d’environnement ou un gestionnaire de secrets
- Restreignez par IP sur les clés de production
- Utilisez des clés en lecture seule pour tableaux de bord et surveillance
- Faites tourner les clés chaque trimestre dans le cadre de l’hygiène standard
- Activez la 2FA sur le compte lui-même, pas seulement sur la clé
- Journalisez toute utilisation de clé côté serveur pour détecter les accès anormaux
Sources
Questions fréquentes
Qu’est-ce qu’une API de trading crypto ?
Une API de trading crypto est une interface programmatique pour passer des ordres, interroger les données de marché et gérer automatiquement les positions. L’API de trading crypto de Volity expose des points REST pour les opérations de compte et d’ordres, plus des flux WebSocket pour les prix en temps réel. Convient aux traders algorithmiques, tableaux de bord personnalisés et intégrations de bots.
L’API de Volity est-elle gratuite ?
Oui. L’API est incluse avec votre compte Volity. Les limites de débit Standard (60 req/min REST, 5 connexions WebSocket) sont fournies avec chaque compte. Les comptes de palier VIP (50 000 € minimum) débloquent des limites plus élevées.
Comment obtenir une clé API ?
Ouvrez le portail de compte Volity, allez dans Paramètres → Accès API, cliquez sur « Générer une clé ». Vous définissez les permissions (lecture seule, trading ou complet), la liste d’IP autorisées et la bascule sandbox/live à la création. Les clés sont révocables à tout moment.
Puis-je faire du trading haute fréquence sur Volity ?
Oui. Les comptes de palier VIP débloquent 600 req/min REST et 25 connexions WebSocket, avec SLA de disponibilité 99,99 % et cross-connects dédiés en option. La couche d’exécution maintient 99,6 % d’exécutions en moins d’une seconde pour les ordres manuels ; les ordres programmatiques s’exécutent à la même vitesse.
L’API prend-elle en charge le backtesting ?
L’API elle-même n’exécute pas de backtests, mais elle expose les données historiques OHLCV via GET /candles que vous pouvez tirer dans le backtester de votre choix (Backtrader, vectorbt, sur mesure). Les comptes de palier VIP obtiennent une profondeur d’historique étendue.
Quels langages puis-je utiliser avec l’API Volity ?
Tout langage gérant HTTP REST et WebSocket. Choix courants : Python, Node.js, Go, Rust, C#, Java. Les EA MQL4 et MQL5 tournent à l’intérieur de Volity MT, pas via l’API REST.
Puis-je utiliser l’API pour copier des trades ?
Oui, sous réserve des exigences réglementaires de votre juridiction. Volity propose également un produit de copy-trading hébergé via /tools/crypto-copy-trading/ pour les utilisateurs qui ne veulent pas construire l’infrastructure eux-mêmes.
