Avertissement sur les risques : Le trading de produits CFD comporte un niveau de risque élevé et peut ne pas convenir à tous les investisseurs.

XBTFX Trading API

Compatible avec les comptes MetaTrader 5® XBTFX

Tradez de manière programmatique, gérez des positions, surveillez l'état de votre compte et streamez des données de marché en temps réel sur des comptes XBTFX MetaTrader 5® compatibles via REST et WebSocket. Construisez des stratégies automatisées, connectez des agents IA et intégrez votre compte dans des flux personnalisés. Démarrez avec la documentation, des exemples, des AI skills ou le serveur XBTFX MCP. Conçu pour les développeurs et les utilisateurs ayant l'expérience de la programmation ou des assistants IA de code.

Comptes Edge et ECN
Accès programmatique complet
Modes hedging et netting
Prêt pour les agents IA (MCP)
terminal
# Send a trade to your XBTFX account curl -X POST https://interface.xbtfx.com/v1/trade \ -H "Authorization: Bearer xbtfx_live_..." \ -H "Content-Type: application/json" \ -d '{ "symbol": "EURUSD", "side": "buy", "volume": 0.10, "sl": 1.08200, "tp": 1.09000 }' # Response { "ticket": 184729, "status": "filled", "price": 1.08650, "retcode": 10009 }
Protocole icon
REST
Protocole
Streaming icon
WebSocket
Streaming
Weight / min icon
600
Weight / min
Format de réponse icon
JSON
Format de réponse

Automatisez votre trading avec la XBTFX API

La XBTFX Trading API vous permet d'envoyer des instructions à votre compte XBTFX MetaTrader 5® compatible. Ouvrez des positions, modifiez des stops, consultez les soldes et streamez des cotations en direct via des appels REST et WebSocket standard.

Stratégies automatisées
Construisez des bots de trading et des stratégies algorithmiques qui envoient des ordres à votre compte automatiquement. Faites tourner de l'exécution sur signal, du rééquilibrage de portefeuille ou de la gestion de risque sur mesure.
Intégration d'agents IA
Connectez des assistants IA à votre compte via le XBTFX Skills Hub ou le serveur MCP. Donnez des ordres en langage naturel via Claude Code, Cursor, Windsurf ou d'autres clients compatibles.
Intégrations sur mesure
Construisez des tableaux de bord, connectez-vous à des sources externes, redirigez des signaux d'autres plateformes ou intégrez les données de votre compte dans vos propres systèmes de reporting et d'analyse.

Endpoints API pour le trading, les positions et les données de marché

Ouvrez et fermez des positions, définissez stop loss et take profit, consultez les soldes, récupérez l'historique et streamez des cotations forex et crypto en direct via WebSocket.

POST Envoyer des ordres
Envoyez des ordres au marché à votre compte avec stop loss et take profit. Prend en charge les modes de marge hedging et netting.
/v1/trade
POST Clôturer et modifier
Clôturez des positions totalement ou partiellement. Mettez à jour SL/TP sur les positions ouvertes. Clôturez tout, par symbole ou nettez les positions opposées.
/v1/close · /v1/modify · /v1/close-all
GET Positions et ordres
Récupérez toutes les positions ouvertes et les ordres en attente en temps réel. Filtrage par symbole. Réponses servies en cache avec mises à jour push en direct.
/v1/positions · /v1/orders
GET Compte et solde
Solde, equity, marge, marge libre, PnL flottant et levier en temps réel. Un seul appel pour un instantané complet.
/v1/account
GET Symboles et spécifications
Liste complète des symboles avec bid/ask en direct, spread, taille de contrat, volume min/max/pas, digits et exigences de marge.
/v1/symbols · /v1/symbols/:symbol
WS Streaming WebSocket
Cotations en streaming temps réel avec profondeur de marché à 5 niveaux. Abonnez-vous aux symboles disponibles sur votre compte.
wss://ws.xbtfx.com/v1/ws

Envoyez votre premier ordre API en quelques minutes

Quelques lignes de code dans le langage de votre choix. HTTP standard — n'importe quel langage capable d'envoyer une requête POST fonctionne.

XBTFX Trading API · examples
# Send a buy order to your XBTFX account curl -X POST https://interface.xbtfx.com/v1/trade \ -H "Authorization: Bearer $XBTFX_API_KEY" \ -H "Content-Type: application/json" \ -d '{"symbol":"EURUSD","side":"buy","volume":0.10,"sl":1.082,"tp":1.09}' # Retrieve open positions curl https://interface.xbtfx.com/v1/positions \ -H "Authorization: Bearer $XBTFX_API_KEY"
import requests API_KEY = "xbtfx_live_your_key_here" BASE = "https://interface.xbtfx.com" HEADERS = {"Authorization": f"Bearer {API_KEY}"} # Send a trade to your account r = requests.post(f"{BASE}/v1/trade", json={ "symbol": "EURUSD", "side": "buy", "volume": 0.10 }, headers=HEADERS) print(r.json()) # {"status": "filled", "retcode": 10009}
const ws = new WebSocket("wss://ws.xbtfx.com/v1/ws"); ws.onopen = () => { ws.send(JSON.stringify({ type: "auth", api_key: "xbtfx_live_..." })); ws.send(JSON.stringify({ type: "subscribe", symbols: ["EURUSD", "BTCUSD"] })); }; ws.onmessage = (e) => { const q = JSON.parse(e.data); console.log(q.symbol, q.bid, q.ask); };
main 0 errors Shell UTF-8 LF interface.xbtfx.com
AI-Ready

Exécutez des ordres en langage naturel

La XBTFX Trading API est conçue pour être consommée par des agents IA et des grands modèles de langage — JSON propre, erreurs lisibles, endpoints prévisibles. Connectez-vous via le XBTFX Skills Hub ou le serveur MCP et votre client IA pourra envoyer des ordres via des commandes conversationnelles.

  • Ordres conversationnels — acheter, vendre, fermer, conditionner aux données.
  • Raisonnement basé sur les outils — chaque action renvoie une réponse structurée.
  • Portable entre clients — Claude, Cursor, Windsurf, Codex.

Moins technique ? Voir notre page AI Agent Trading.

Exemple de conversation →
XBTFX Trading Agent
online · executing trades
Today · 13:25 GMT
If today's NFP prints above 200k, close all my open EURUSD and GBPUSD trades.
13:25 ✓✓
Got it. Watching the BLS release at 13:30 GMT. I'll close 4 positions if NFP > 200k.
13:25
tool · xbtfx_get_positions4 open · EURUSD ×2, GBPUSD ×2 · floating +$184.20
13:26
13:30 · NFP released — 247k (forecast 195k)
tool · xbtfx_close_all (filter: EURUSD, GBPUSD)Closed 4 positions in 38 ms · realized +$212.80
13:30

Exemple illustratif. Les flux conditionnels dépendent de l'agent et des flux de données de marché configurés.

Cas d'usage

Ce que les agents IA font avec l'API

Quatre schémas courants observés dans les flux automatisés et pilotés par IA sur les comptes XBTFX.

Trading événementiel

L'IA surveille les news et les données économiques en temps réel et envoie des ordres à votre compte quand un événement marquant le marché est détecté.

Gestion intelligente du risque

L'IA suit votre marge, votre PnL flottant et votre exposition, ajustant les stops, réduisant les tailles ou clôturant des positions pour protéger le capital.

Rééquilibrage de portefeuille

Définissez des allocations cibles et laissez l'IA les maintenir, en envoyant des ordres d'ajustement quand le drift dépasse votre seuil.

Analyse autonome

Demandez à votre IA d'analyser votre historique de trades, de calculer le taux de réussite par symbole et d'identifier vos meilleurs setups.

Pensé pour votre compte XBTFX existant

Utilisez votre compte MetaTrader 5 Edge ou ECN actuel, votre devise de base existante et votre mode de marge actuel. L'API se branche sur le compte avec lequel vous tradez déjà.

Spécifications techniques

Endpoints prêts pour la production

Modes hedging et netting

Les deux modes de marge MT5 sont pris en charge. Le mode est lié à votre clé API.

Clés d'idempotence

Envoyez la même clé en moins de 120 secondes et nous renvoyons la réponse en cache. Reprises sécurisées, pas de doublons.

Rate limits par poids

600 weight / min par clé. Lectures et trades coûtent 1, les opérations groupées 10. Les en-têtes exposent votre budget restant à chaque réponse.

FIX 4.4 institutionnel

Accès FIX 4.4 via l'infrastructure xPro pour prime brokers, hedge funds et firmes HFT. Contacter les ventes.
Compatibilité de compte

Edge ou ECN — le même compte

Comptes Edge et ECN

Spreads plus serrés avec commission par lot. L'API traite chaque compte Edge / ECN à l'identique — mêmes endpoints, même JSON, même flux d'authentification.

Comptes PAMM, MAM et Copy Master

Les comptes de gestionnaire peuvent être pilotés de manière programmatique via l'API pour les allocations, le rééquilibrage et l'exécution. Contactez l'onboarding pour le provisionnement des accès.

Règlement multidevises

Toutes les devises de base XBTFX MT5 disponibles pour Edge et ECN : USD, EUR, USDT, BTC, ETH, XRP, SOL, LTC, ZEC, XAU. Le solde, l'equity, la marge et le PnL sont renvoyés dans la devise native du compte — sans logique de conversion à coder.

Hedging ou netting

Quel que soit le mode de marge configuré sur votre compte MT5, c'est celui qu'utilise l'API. Aucune reconfiguration nécessaire.

Ressources développeurs

Exemples de code, fichiers AI skill et documentation API complète — tout ce qu'il faut pour vous lancer.

Documentation API

Référence complète des endpoints avec exemples de requête/réponse, guide d'authentification et intégration WebSocket.

Exemples API

Code d'exemple en Python, JavaScript, curl et plus encore. Copiez et exécutez.

AI Skills Hub

Fichiers de skills pour les flux trading, compte, données de marché et WebSocket dans les frameworks d'agents compatibles.

MCP Server

Pour Claude Code, Claude Desktop, OpenAI Codex, Cursor, Windsurf et autres clients compatibles MCP.

Démarrez en trois étapes

Même structure, deux points de départ — choisissez celui qui correspond à l'état de votre compte.

1
Générez une clé API
Connectez-vous à console.xbtfx.com avec vos identifiants XBTFX, sélectionnez votre compte de trading et générez une clé.
Ouvrir Console
2
Installez une skill ou MCP
Installez une skill depuis le Skills Hub, ou connectez le serveur MCP à Claude Code, Cursor, Windsurf ou d'autres clients compatibles. Les clés restent en local.
Documentation MCP
3
Commencez à trader
Vérifiez avec GET /v1/auth/status, puis envoyez des commandes en langage naturel ou appelez directement les endpoints REST/WebSocket.
Lire la documentation

Frequently
Asked Questions

  • Qu'est-ce que la XBTFX Trading API ?

    La XBTFX Trading API offre un accès REST et WebSocket pour le trading programmatique, le suivi de compte, la récupération de données de marché et le streaming sur des comptes XBTFX MetaTrader 5® compatibles. Elle est construite par XBTFX — vous interagissez avec des endpoints HTTP propres et des réponses JSON pour envoyer des ordres et récupérer les données de votre compte.

  • Quels langages de programmation puis-je utiliser ?

    Tout langage capable d'envoyer des requêtes HTTP. Python, JavaScript, Go, Rust, C#, Java, Ruby, PHP — s'il peut envoyer un POST avec un corps JSON, il peut envoyer des ordres à votre compte XBTFX via l'API.

  • Puis-je construire des stratégies de trading automatisé ?

    Oui. La XBTFX Trading API est conçue pour le trading algorithmique et automatisé. Vous pouvez bâtir des bots basés sur des signaux, des rééquilibreurs de portefeuille, des systèmes de gestion de risque ou toute logique sur mesure qui envoie des ordres à votre compte.

  • Existe-t-il un flux WebSocket de prix en temps réel ?

    Oui. La XBTFX Trading API expose un endpoint WebSocket pour streamer des cotations en temps réel sur les symboles disponibles dans votre compte. Les cotations incluent une profondeur de marché à 5 niveaux quand elle est disponible. Jusqu'à 1 000 abonnements de symboles par connexion et jusqu'à 10 connexions simultanées.

  • Quelle est la différence entre les modes hedging et netting ?

    Ce sont des modes de marge qui déterminent le comportement des positions. Hedging permet plusieurs positions indépendantes par symbole, y compris d'achat et de vente opposées. Netting agrège tout en une seule position par symbole. Votre clé API hérite du mode de votre compte.

  • Quels sont les rate limits ?

    600 weight par minute par clé API. La plupart des requêtes coûtent 1 weight — jusqu'à 600 appels par minute. Les opérations groupées comme close-all coûtent 10 weight. Chaque réponse inclut des en-têtes indiquant le budget restant.

  • Puis-je trader des CFD crypto via l'API ?

    Oui. Tout symbole disponible sur votre compte XBTFX est accessible via l'API — y compris les CFD sur cryptomonnaies. Vous pouvez aussi utiliser l'API avec des comptes en BTC, ETH, USDT ou XRP.

  • L'API est-elle gratuite ?

    Oui. La XBTFX Trading API est incluse avec chaque compte de trading sans coût additionnel. Pas de frais d'API, pas d'abonnement, pas de coûts par appel au-delà de vos commissions et spreads de trading habituels.

  • Comment obtenir une clé API ?

    Créez d'abord un compte de trading XBTFX sur my.xbtfx.com si vous n'en avez pas. Connectez-vous ensuite à l'API Console sur console.xbtfx.com avec vos identifiants XBTFX, sélectionnez votre compte et générez une clé. Vérifiez son fonctionnement en envoyant GET /v1/auth/status avant de placer des ordres.

  • Puis-je utiliser l'API avec un compte démo ?

    Oui. Les clés API fonctionnent à la fois sur les comptes réels et démo. Cela vous permet de tester votre intégration et de valider votre code avant de passer en réel — sur la même API et les mêmes endpoints.

  • Que faire avant de placer des ordres ?

    Vérifiez d'abord le statut de votre clé et de votre compte en envoyant GET /v1/auth/status. Cela confirme que votre clé est valide, montre vos permissions et votre mode de marge, et garantit que votre compte est prêt avant tout envoi d'ordres.

  • Faut-il une expérience de programmation ?

    Utiliser l'API REST directement demande des bases en programmation. Cependant, avec les voies d'intégration IA, vous n'avez pas besoin d'écrire du code — connectez le serveur XBTFX MCP à Claude Code ou Cursor, ou installez une skill depuis le Skills Hub, et donnez des ordres en langage naturel. Une certaine familiarité avec les assistants IA de code est recommandée.

  • Puis-je utiliser l'IA pour trader mon compte ?

    Oui. Utilisez le XBTFX Skills Hub pour les frameworks d'agents qui supportent les fichiers de skill, ou connectez le serveur XBTFX MCP à des clients compatibles MCP comme Claude Code, Claude Desktop, OpenAI Codex, Cursor ou Windsurf. Les deux voies permettent d'envoyer des ordres en langage naturel via la XBTFX Trading API.

  • Est-il sûr de donner accès à mon compte à un agent IA ?

    Les clés API sont généralement stockées localement par l'agent sur votre machine et ne sont pas téléversées sur des serveurs tiers. L'agent envoie les appels API directement aux serveurs XBTFX avec votre clé. Vous pouvez révoquer la clé à tout moment depuis le Console. Nous recommandons de commencer avec un compte démo pour tester votre setup avant de passer en réel.