Un runtime natif IA pour vos stratégies de trading Bitfinex
Développez dans Cursor, Claude Code ou n'importe quel IDE IA. Déployez depuis GitHub sur un runtime cloud géré avec contrôle MCP natif, logs et choix de la région.
Section 01 · En un coup d’œil
En un coup d’œil
- Plateforme
- Bitfinex
- Type de plateforme
- Plateforme d'échange crypto (spot, marge, dérivés)
- Classe d’actifs
- Crypto
- Produits pris en charge
- Spot, marge (financée par un funding pool de pair à pair), dérivés (contrats perpétuels) sur derivatives.bitfinex.com. Les jetons de titres (securities) via Bitfinex Securities fonctionnent comme une plateforme distincte.
- Modèle d’exécution
- Runtime de stratégie conteneurisé (Kubernetes)
- Source de déploiement
- GitHub
- Langages
- Tout langage s'exécutant dans un conteneur
- Intégrations courantes
- REST v2 natif Bitfinex, WebSocket v2, Honeycomb FIX 4.4, CCXT (bitfinex, bitfinex2), Freqtrade (via CCXT), sur mesure
- Intégration du workflow d’IA
- Interface de contrôle MCP pour Cursor, Claude Code, GitHub Copilot et agents CLI
- Rôle de TradingHost
- Runtime, déploiement, logs, bilans de santé (health checks), choix de la région, secrets, contrôle MCP
- Rôle de Bitfinex
- Compte d'échange, émission des clés API, accès au marché, appariement des ordres, garde (custody), règlement
- Affiliation
- TradingHost est indépendant et n'est pas affilié à Bitfinex ni à iFinex Financial Technologies Limited. Bitfinex ne s'adresse pas aux clients domiciliés aux États-Unis.
Section 02 · Ce que propose Bitfinex
Ce que propose Bitfinex
Bitfinex propose le trading spot, sur marge et sur dérivés via REST v2 et WebSocket v2, ainsi que Honeycomb FIX 4.4 pour les clients institutionnels. La marge est financée par un funding pool de pair à pair plutôt que par la plateforme elle-même, ce qui fait du prêt de fonds (lending) un axe de stratégie à part entière. Les contrats perpétuels se négocient sur derivatives.bitfinex.com selon la convention des F0 symbols (par exemple tBTCF0:USTF0) et nécessitent de l'USDt0 dans un portefeuille de dérivés dédié. Les spécificités des endpoints évoluent avec le temps ; l'architecture globale reste stable, tandis que les limites de requêtes (rate limits), les paliers de frais et les listes de symboles précis sont détaillés dans la documentation de Bitfinex.
Marchés et types de stratégies
- Market making spot sur tBTCUSD et tETHUSD
- Trading sur marge financé via le funding pool de pair à pair
- Trading de contrats perpétuels sur derivatives.bitfinex.com (F0 symbols)
- Stratégies de taux de financement côté prêt (offres fUSD, fBTC)
- HFT institutionnel via Honeycomb FIX 4.4
- Isolation des stratégies par sub-accounts dédiés
- Placement d'ordres Post-only et cachés (order flags)
- Logique d'ordres liés One-Cancels-Other (OCO)
Interface API
- Produits couverts
- Spot, marge (funding pool), dérivés (perpétuels via F0 symbols, nécessite de l'USTF0 dans le portefeuille de dérivés), titres (séparé). Paper trading via tTESTBTCF0:TESTUSDTF0.
- Méthodes de connexion
- REST v2 (public sur api-pub.bitfinex.com, authentifié sur api.bitfinex.com), WebSocket v2 (wss://api-pub.bitfinex.com/ws/2 et wss://api.bitfinex.com/ws/2), Honeycomb FIX 4.4 pour les institutionnels. Les versions REST et WS v1 restent disponibles mais la v2 est recommandée.
- Authentification
- Clé API et secret avec un nonce strictement croissant et signature HMAC-SHA384. Le nonce ceiling est de 9007199254740991. Chaque client simultané nécessite sa propre clé pour éviter les collisions de nonces. Les permissions sont définies par clé (informations de compte, ordres, marge, financement, retraits).
Pour plus de détails, reportez-vous à Bitfinex
Les endpoints spécifiques, les limites de requêtes, les listes de symboles, les paliers de frais et l'historique des versions se trouvent dans la documentation de Bitfinex. Considérez-les comme la source de vérité unique.
Section 03 · Développer avec l’IA
Développez votre stratégie Bitfinex avec l’IA
Choisissez une méthode d'intégration, dupliquez (fork) un modèle de départ TradingHost et développez votre stratégie dans un IDE IA. Cursor, Claude Code, GitHub Copilot et les agents IA en ligne de commande fonctionnent tous avec le même cycle de déploiement natif GitHub. Le modèle de marge distinctif de Bitfinex (un funding pool de pair à pair plutôt qu'une marge financée par la plateforme) ainsi que la convention des F0 symbols sur la plateforme de dérivés distincte déterminent la façon dont chaque framework s'interface avec la plateforme.
API Bitfinex native
Contrôle direct du comportement spécifique à Bitfinex, des données de compte et de la logique d'exécution des ordres via REST v2 et WebSocket v2.
CCXT
Interface commune entre Bitfinex et d'autres plateformes d'échange crypto. CCXT expose Bitfinex sous deux identifiants : `bitfinex` (v1) et `bitfinex2` (v2). Les nouveaux développements doivent cibler `bitfinex2`.
Freqtrade ou Hummingbot
Déploiements basés sur des frameworks utilisant leur propre structure de stratégie et modèle de configuration. Freqtrade accède à Bitfinex via CCXT ; Hummingbot propose historiquement un connecteur spot pour Bitfinex.
Connecteur sur mesure
Votre propre moteur de trading interne ou intégration propriétaire Bitfinex, y compris Honeycomb FIX 4.4 pour les clients institutionnels.
Compatibilité des frameworks avec les produits Bitfinex
La couverture varie selon le framework. L'API native REST v2 et WebSocket v2 couvre l'intégralité de l'écosystème Bitfinex, y compris les contrats perpétuels F0 sur la plateforme de dérivés et le funding pool. CCXT expose Bitfinex via deux identifiants (`bitfinex` pour la v1, `bitfinex2` pour la v2) ; `bitfinex2` est recommandé pour les nouvelles stratégies. Freqtrade accède à Bitfinex via CCXT pour le spot, la marge et les futures n'étant pas officiellement supportés. Hummingbot propose un connecteur uniquement pour le spot Bitfinex.
✓ support confirmé selon la documentation officielle du framework. « partial » ou « limited » indique que le framework accède à l'interface mais ne couvre pas l'intégralité du produit Bitfinex. « no » indique qu'aucun support n'est officiellement documenté. Les liens de workflow pointent vers les pages /workflows/ actuellement en cours de rédaction.
TradingHost n’impose aucun framework. Il exécute votre projet.
Développer avec l’IA
Les starters de framework ci-dessus s’associent naturellement avec les AI IDE. L’interface de contrôle MCP de TradingHost ferme la boucle : les outils d’IA peuvent inspecter les déploiements, consulter les journaux et gérer l’environnement d’exécution à vos côtés, sans jamais interférer avec le flux d’exécution des ordres.
Section 04 · Exécuter sur TradingHost
Exécutez votre code sur TradingHost
Bitfinex fournit la plateforme d’échange et l’accès API. TradingHost fournit l’environnement de production où s’exécute votre stratégie connectée à Bitfinex.
Au lieu d’exécuter le code de votre stratégie sur un ordinateur portable, un ordinateur de bureau, un VPS générique ou un serveur configuré manuellement, vous le déployez depuis GitHub dans un environnement d’exécution de conteneurs géré par TradingHost.
Vous
- Votre dépôt contient votre code.
- Votre déploiement définit son mode d’exécution.
- Votre stratégie se connecte à Bitfinex.
TradingHost
- Maintient l’environnement d’exécution en ligne.
- Affiche les logs et les contrôles d’état.
- Sélection de la région.
- Surface de déploiement contrôlée.
Flux de déploiement
- ÉTAPE 01
Connecter GitHub
Autorisez TradingHost à accéder à votre compte GitHub.
- ÉTAPE 02
Associez un dépôt ou démarrez depuis un framework
Dirigez TradingHost vers le dépôt de votre stratégie existante, ou forkez un environnement de framework TradingHost (CCXT, Freqtrade ou Hummingbot) pour obtenir une base de travail fonctionnelle.
- ÉTAPE 03
Déployer dans un conteneur TradingHost
Choisissez une région (EU ou US-East), renseignez les variables d'environnement requises par votre stratégie (clé API Bitfinex, secret, etc.) et déployez. TradingHost construit votre conteneur à partir du dépôt et exécute votre stratégie sur une infrastructure Kubernetes managée. Bitfinex impose une monotonicité stricte du nonce par clé ; exécutez donc une seule clé API par processus worker. Pour exécuter plusieurs stratégies simultanées, générez une clé par stratégie sous un sub-account afin d'éviter les conflits sur l'espace des nonces. Aucune installation locale de Docker n'est requise.
- ÉTAPE 04
Suivre les logs et l’état de santé
Suivez en direct les logs, l’état de santé et l’état d’exécution depuis le tableau de bord TradingHost. Cette même interface est accessible via MCP depuis n’importe quel AI IDE, permettant à Cursor, Claude Code ou un agent en ligne de commande de lire l’état du déploiement et de gérer le runtime à vos côtés.
- ÉTAPE 05
Mettre à jour et redéployer
Poussez vos modifications sur votre branche principale GitHub et TradingHost relance automatiquement le déploiement.
Section 05 · Notes opérationnelles
Notes opérationnelles pour Bitfinex
Les pièges qui vous guettent lorsque vous exécutez réellement une stratégie Bitfinex dans un runtime cloud conteneurisé — absents de la documentation de Bitfinex et des fichiers README des frameworks. Chaque point ci-dessous est cité ou paraphrasé à partir de la documentation officielle de Bitfinex ; les conseils de déploiement sont issus de l'exploitation de ces stratégies sur TradingHost.
01 · Monotonicité du nonce
Strictly increasing per key, with a hard ceiling
Chaque requête authentifiée nécessite un nonce strictement croissant par clé API ; cette valeur a également un plafond absolu (nonce ceiling 9007199254740991). Des processus simultanés partageant une même clé entreront en collision. Solution : une clé API par stratégie ou conteneur actif, isolée via des sub-accounts.
02 · v1 vs v2
v2 est la voie recommandée pour l'avenir
L'API REST v1 s'authentifie toujours via les en-têtes X-BFX-APIKEY, X-BFX-PAYLOAD et X-BFX-SIGNATURE avec une charge utile JSON en Base64. La v2 est la voie recommandée, offrant des endpoints plus rapides et des réponses unifiées ; tout nouveau code devrait cibler la v2.
03 · sub-accounts
Un compte maître, plusieurs sub-accounts, espaces de nonce distincts
Bitfinex prend en charge plusieurs sub-accounts sous un seul compte maître. Chaque sub-account possède ses propres clés API, portefeuilles et espace de nonce, ce qui est la méthode recommandée pour isoler les stratégies et éviter les conflits de nonce.
SourceBitfinex API access04 · funding pool
La marge est de pair à pair, non financée par l'exchange
La marge sur Bitfinex est financée par des prêteurs de pair à pair qui publient des offres en fUSD, fBTC, etc. Les stratégies d'emprunt et de prêt s'exécutent toutes deux sur le même carnet de financement ; le flag `No Var Rates` (524288) exclut les offres à taux variable de l'appariement.
SourceBitfinex flag values05 · Séparation des dérivés
Les contrats perpétuels s'échangent sous forme de F0 symbols sur une plateforme distincte
Les contrats perpétuels s'échangent sous forme de F0 symbols (par exemple tBTCF0:USTF0, tETHF0:USTF0) gérés par iFinex Financial Technologies Limited. Ils nécessitent du USDt0 dans un portefeuille de dérivés dédié ; utilisez l'endpoint Transfer Between Wallets pour y transférer des fonds. L'effet de levier est de 10 par défaut, et configurable de 1 à 100 lors de l'ordre.
SourceBitfinex derivatives06 · Honeycomb FIX
FIX 4.4 est un accès institutionnel restreint
L'interface FIX est réservée aux institutionnels ; l'accès ne se fait pas en libre-service depuis la page API standard. Prévoyez des étapes supplémentaires d'onboarding et d'obtention de clés d'accès avant de vous appuyer sur FIX dans un déploiement TradingHost.
07 · Limites de requêtes
Limites REST par IP et plafonds de connexion WebSocket
Les limites REST sont d'environ 10 à 90 requêtes par minute et par IP selon l'endpoint, avec un délai de récupération de 60 secondes en cas de dépassement. Plafonds WebSocket : 5 connexions authentifiées toutes les 15 secondes, 20 connexions publiques par minute, 25 abonnements à des canaux par connexion. Les stratégies qui se déploient sur de nombreux marchés devraient regrouper les canaux plutôt que d'ouvrir de multiples sockets.
Section 06 · Conçu pour
Conçu pour
Les runtimes TradingHost pour Bitfinex sont particulièrement adaptés aux :
- Les market makers Spot qui recherchent une plateforme USD/USDT historique et profonde
- Les traders sur marge qui recherchent spécifiquement le modèle de funding pool de pair à pair
- Les prêteurs côté financement qui exécutent des stratégies de taux sur des offres fUSD, fBTC, fETH
- Les traders de contrats perpétuels utilisant tBTCF0:USTF0 et d'autres paires F0
- Les desks institutionnels ayant besoin d'une connectivité FIX 4.4 en plus de HTTP et WebSocket
La connexion à GitHub et la création de votre première stratégie sont gratuites.
Section 08 · FAQ
FAQ
Non. TradingHost est indépendant et n'est pas affilié à Bitfinex ni à iFinex Financial Technologies Limited, l'opérateur de la plateforme de dérivés de Bitfinex.
Non. Le code de votre stratégie se connecte à Bitfinex et envoie des instructions selon votre propre logique, vos autorisations de compte et votre méthode d'intégration. TradingHost fournit l'environnement d'exécution (runtime) dans lequel ce code s'exécute.
Non. L'accès à l'API Bitfinex est fourni par Bitfinex. Vous êtes responsable de votre compte Bitfinex, des autorisations de l'API, de vos identifiants et du respect des conditions d'utilisation de Bitfinex.
Non. TradingHost est le runtime cloud où s'exécute le code de votre stratégie. Nous ne fournissons pas de signaux, de modèles de prédiction IA ou de bots préconçus. Avec TradingHost, vous écrivez ou générez vous-même la stratégie (souvent avec Cursor ou Claude Code), vous la conservez sur GitHub sous forme de code, et vous utilisez TradingHost pour l'exécuter en production. Des produits comme 3Commas ou Cryptohopper possèdent la logique de la stratégie ; TradingHost exécute votre propre stratégie.
AWS et DigitalOcean vous fournissent de la puissance de calcul brute. Vous devez gérer vous-même les mises à jour de l'OS, l'orchestration des conteneurs, la centralisation des logs, la rotation des secrets, le basculement de région et la surveillance de la disponibilité. TradingHost vous offre un runtime managé conçu spécifiquement pour les stratégies de trading : déploiement natif depuis GitHub, contrôle piloté par MCP depuis vos IDE IA, interfaces de logs et de santé prêtes à l'emploi. Si vous souhaitez gérer l'infrastructure vous-même, AWS convient parfaitement. Si vous préférez un runtime sous forme de service managé, TradingHost est la voie la plus rapide.
Oui. TradingHost exécute des stratégies en Python ; choisissez le runtime de framework qui correspond à votre stack ou déployez votre propre dépôt.
Oui. TradingHost prend en charge n'importe quel langage capable de s'exécuter dans un conteneur.
Oui. CCXT expose Bitfinex sous deux identifiants : bitfinex cible l'API v1 et bitfinex2 cible la v2. Utilisez bitfinex2 pour les nouvelles stratégies ; la v2 est la voie recommandée. Notez que certaines paires listées sur Bitfinex utilisent USD alors que l'actif sous-jacent est en réalité USDT, ce que CCXT normalise lors de la conversion. Consultez le runtime du framework CCXT pour connaître tous les détails de configuration.
La marge est financée par un carnet de pair à pair, et non par l'exchange. Les prêteurs publient des offres de financement en fUSD, fBTC, etc., que les emprunteurs utilisent lors de l'ouverture de positions sur marge. Le côté prêt constitue lui-même un axe de stratégie, ce qui est inhabituel parmi les principales plateformes.
Les contrats perpétuels s'échangent sur derivatives.bitfinex.com sous forme de F0 symbols (par exemple tBTCF0:USTF0). Ils nécessitent du USDt0 dans un portefeuille de dérivés dédié, géré par iFinex Financial Technologies Limited. Transférez des fonds via l'endpoint Transfer Between Wallets. L'effet de levier est configurable par ordre, avec une valeur par défaut de 10 et pouvant aller jusqu'à 100.
Non. Bitfinex ne dessert pas les clients domiciliés aux États-Unis. Si vous êtes aux États-Unis, utilisez plutôt Coinbase ou Kraken. TradingHost exécute votre runtime quelle que soit la région, mais la plateforme elle-même doit accepter votre compte.
Oui, si votre projet est conçu ainsi. Vous pouvez exécuter plusieurs processus ou services de stratégie au sein d'un même runtime, ou les séparer dans différents runtimes pour plus d'isolation et de clarté opérationnelle. Chaque stratégie active devrait posséder sa propre clé API (idéalement sous un sub-account) afin d'éviter les collisions liées à la stricte monotonie du nonce par clé. Consultez la page des runtimes TradingHost pour en savoir plus sur le modèle multi-stratégie.
La voie la plus rapide consiste à forker un runtime de framework TradingHost : CCXT ou Freqtrade pour un projet prêt à être déployé. Vous pouvez également connecter votre propre dépôt de stratégie GitHub. Lier un dépôt GitHub et créer une stratégie est gratuit ; les abonnements de runtime sont détaillés sur la page des tarifs.
Dans votre workflow de secrets contrôlé par GitHub. TradingHost les lit au moment de l'exécution via les secrets de dépôt GitHub, les secrets d'environnement ou votre propre processus approuvé de gestion des secrets. TradingHost n'a pas besoin de conserver vos clés API et secrets. Consultez la section sur les secrets de la plateforme pour connaître l'intégralité du modèle de gestion.
Non. Les stratégies ne devraient jamais avoir besoin de permissions de retrait. Utilisez des permissions restreintes (informations de compte, ordres, marge, financement) et n'activez que les accès dont votre stratégie a réellement besoin.
Oui. TradingHost prend en charge le contrôle basé sur MCP pour les IDE IA, notamment Cursor, Claude Code, GitHub Copilot et les agents IA en ligne de commande (CLI). Les outils d'IA peuvent inspecter les déploiements, consulter les journaux, redémarrer les stratégies et gérer les flux de travail d'exécution. MCP est une surface de contrôle et d'observabilité, pas le chemin d'exécution des transactions. Consultez la surface de contrôle MCP pour en savoir plus.
Les deux. La surface de contrôle MCP fonctionne aussi bien depuis des agents en ligne de commande (Claude Code CLI, clients MCP personnalisés, appels MCP scriptés) que depuis un IDE. Le cycle de déploiement natif via GitHub fonctionne également sans aucun outil d'IA : un simple git push sur votre branche principale déclenche un nouveau déploiement.
L'environnement d'exécution détecte le plantage et expose les journaux et les informations d'état correspondants. Lorsque cela est possible, la stratégie concernée peut être redémarrée sans perturber les autres stratégies exécutées dans le même conteneur. Le code de votre stratégie reste responsable de la gestion sécurisée des erreurs, de la protection contre les ordres doublons et des contrôles de risque. Consultez la section observabilité pour en savoir plus sur les journaux et l'état du système.
Bitfinex impose un nonce strictement croissant par clé API, limité à un nonce ceiling 9007199254740991. Deux processus partageant la même clé entreront en collision et l'un d'eux sera rejeté. Pour résoudre ce problème, attribuez à chaque stratégie active sa propre clé API, idéalement sur son propre sub-account. Consultez la section Notes opérationnelles ci-dessus pour obtenir toutes les instructions.
TradingHost est disponible dans les régions EU et US-East. Choisissez la région la plus proche du moteur d'appariement dont dépend votre stratégie. Consultez la page des régions pour obtenir des détails sur le routage et la proximité.
Non. TradingHost se concentre exclusivement sur l'environnement d'exécution en production et le déploiement. Le backtesting relève de votre infrastructure de recherche, de votre framework ou d'AlgoBuilder.