Runtime natif IA pour vos stratégies de trading Bitvavo
Développez dans Cursor, Claude Code ou n'importe quel IDE IA. Déployez depuis GitHub dans un runtime cloud managé avec contrôle MCP natif, logs et sélection de régions en Europe.
Section 01 · En un coup d’œil
En un coup d’œil
- Plateforme
- Bitvavo
- Type de plateforme
- Plateforme d'échange crypto (centralisée, basée dans l'UE)
- Classe d’actifs
- Crypto
- Produits pris en charge
- Spot uniquement. Sans marge, sans futures, sans dérivés ; levier 1:1 sur une seule plateforme au comptant.
- Modèle d’exécution
- Runtime de stratégie conteneurisé
- Source de déploiement
- GitHub
- Langages
- Tout langage compatible avec un conteneur
- Intégrations courantes
- REST et WebSocket natifs Bitvavo, CCXT (`bitvavo`), CCXT Pro, Freqtrade, SDK officiels Bitvavo (Python, Node.js, Go, Java), 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, health checks, sélection de région, contrôle MCP
- Rôle de Bitvavo
- Compte d'échange, accès API, accès au marché, exécution des ordres, passerelles EUR
- Affiliation
- TradingHost est indépendant et n'est pas affilié à Bitvavo. Bitvavo B.V. est supervisé par l'AFM sous le régime MiCA (autorisation accordée en juin 2025) et enregistré auprès de De Nederlandsche Bank (DNB).
Section 02 · Ce que propose Bitvavo
Ce que propose Bitvavo
Bitvavo est une plateforme d'échange au comptant basée dans l'UE, proposant des passerelles fiat en EUR (SEPA, SEPA Instant, iDEAL) et bénéficiant d'une autorisation MiCA dans tout l'EEA. Les stratégies accèdent à la plateforme via REST et WebSocket, avec une authentification par clés API signées par HMAC-SHA256 et limitées à des permissions spécifiques. Sans dérivés, sans marge ni perpetuals, l'interface est volontairement plus simple que celle des plateformes multi-produits.
Marchés et types de stratégies
- Grid trading spot en EUR
- DCA récurrent en EUR sur les cryptos majeures
- Arbitrage de paires fiat EUR vs plateformes USD
- Exécution à faible latence en Europe depuis un runtime proche d'Amsterdam
- Market making spot sur les paires en EUR
- Retour à la moyenne sur les paires EUR / altcoins
- Rééquilibrage de portefeuille sur les actifs au comptant
- Hébergement de stratégies retail conforme à MiCA (passeport EEA)
Interface API
- Produits couverts
- Spot uniquement. Sans futures, sans marge ni options. Les paires libellées en EUR dominent ; des marchés de cotation en USDC, USDT et BTC sont également disponibles.
- Méthodes de connexion
- REST sur `https://api.bitvavo.com/v2/`. WebSocket sur `wss://ws.bitvavo.com/v2/`. Une API FIX est également proposée aux clients institutionnels (hors libre-service).
- Authentification
- Clé API et requêtes signées par HMAC-SHA256. En-têtes : `Bitvavo-Access-Key`, `Bitvavo-Access-Signature`, `Bitvavo-Access-Timestamp`, `Bitvavo-Access-Window` (par défaut 10000 ms). La signature correspond au condensé hexadécimal HMAC SHA-256 de `timestamp + method + url + body`, avec la clé secrète de l'API. Autorisation d'IP optionnelle par clé (fortement recommandée). Permissions des clés API : View, Trade, Withdraw, Subaccount, Internal Transfer, Administrative.
Pour plus de détails, reportez-vous à Bitvavo
Les endpoints spécifiques, les poids des limites de taux, les listes de symboles et les paliers de frais figurent dans la documentation de Bitvavo. Référez-vous-y comme source de vérité.
Section 03 · Développer avec l’IA
Développez votre stratégie Bitvavo avec l’IA
Choisissez une méthode d’intégration, dupliquez (fork) un starter de framework TradingHost et concevez votre stratégie dans un AI IDE. Cursor, Claude Code, GitHub Copilot et les agents IA en ligne de commande fonctionnent tous avec le même cycle de déploiement natif sur GitHub.
API native Bitvavo
Contrôle direct du comportement spécifique à Bitvavo, des données de compte et de la logique d'exécution des ordres via REST, WebSocket ou FIX institutionnel.
CCXT
Interface commune entre Bitvavo et d'autres plateformes d'échange crypto. CCXT Pro ajoute le support WebSocket.
Freqtrade
Déploiements basés sur le framework Freqtrade. Le support de Bitvavo est testé par la communauté via CCXT ; pas de stoploss sur la plateforme.
Connecteur sur mesure
Votre propre moteur de trading interne ou intégration propriétaire Bitvavo, ou l'un des SDK officiels de Bitvavo (Python, Node.js, Go, Java).
Compatibilité des frameworks avec Bitvavo
Bitvavo étant limité au spot, la matrice des frameworks est plus simple que pour les plateformes multi-produits : il n'y a pas de colonne USD-M, COIN-M ou options à remplir. Si votre stratégie nécessite des perpetuals ou des futures avec marge en USD, associez Bitvavo à une autre plateforme (par exemple Binance, Bybit ou OKX) pour la partie dérivés. Pour les stratégies spot uniquement sur Bitvavo, les trois principaux frameworks ainsi que l'API native sont supportés ; Hummingbot ne propose pas de connecteur Bitvavo pour le moment.
✓ support confirmé selon la documentation officielle du framework. « no connector » indique que le framework ne propose pas de connecteur Bitvavo. Les liens de workflow renvoient vers les pages /workflows/ 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
Bitvavo 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 à Bitvavo.
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 à Bitvavo.
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
Pointez TradingHost vers votre dépôt de stratégie existant, ou dupliquez (fork) un runtime de framework TradingHost (CCXT ou Freqtrade) pour obtenir une base 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és API Bitvavo : les en-têtes `Bitvavo-Access-Key`, `Bitvavo-Access-Signature`, `Bitvavo-Access-Timestamp` et `Bitvavo-Access-Window` sont générés à partir de celles-ci), puis déployez. TradingHost construit votre conteneur à partir du dépôt et exécute votre stratégie sur une infrastructure Kubernetes managée. 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 Bitvavo
Les pièges réels lors de l'exécution d'une stratégie Bitvavo dans un runtime cloud conteneurisé, absents de la documentation de Bitvavo ou des fichiers README des frameworks. Chaque point ci-dessous est cité ou paraphrasé de la documentation officielle de Bitvavo ; les conseils de déploiement sont issus de l'exploitation de ces stratégies sur TradingHost.
01 · Limites de taux
Limite de taux basée sur un système de poids, 1000 points par minute
Bitvavo applique une limite de taux pondérée partagée entre REST et WebSocket. Le plafond par défaut est de 1000 points de poids par minute, suivi par clé API pour les requêtes authentifiées et par IP sinon. Les réponses incluent les en-têtes `bitvavo-ratelimit-limit`, `bitvavo-ratelimit-remaining` et `bitvavo-ratelimit-resetat`. Tout dépassement renvoie une erreur HTTP 429 avec le code `errorCode 105` et bloque les appels authentifiés pendant 1 minute (15 minutes pour les appels non authentifiés).
SourceBitvavo rate limits02 · WebSocket
Endpoint unique, abonnements JSON basés sur des actions
Un point de terminaison WebSocket unique à l'adresse `wss://ws.bitvavo.com/v2/` gère à la fois les données de marché publiques et le trading authentifié. Les abonnements et les opérations d'ordre sont envoyés sous forme de messages JSON avec un paramètre `action`. La limitation standard autorise jusqu'à 5000 messages par seconde ; Market Data Pro est limité à 50/s ; les deux renvoient `errorCode 112` en cas de dépassement.
03 · Clés API
Portées de permission granulaires et liste blanche d'adresses IP
Lors de la création d'une clé dans le tableau de bord Bitvavo, vous choisissez n'importe quelle combinaison de portées parmi View, Trade, Withdraw, Subaccount, Internal Transfer et Administrative. La liste blanche d'adresses IP est facultative mais fortement recommandée ; sans elle, toute personne détenant les identifiants peut agir sur le compte. Bitvavo signale que les retraits initiés via l'API contournent la 2FA, la portée Withdraw ne doit donc être activée que si elle est réellement nécessaire.
04 · Erreurs d'authentification
305 / 307 / 309 : les erreurs de signature et d'IP à connaître
Les échecs d'authentification les plus courants rencontrés par les développeurs sont l'erreur `errorCode 307` (« this key does not allow access from this IP ») lorsque l'hôte appelant est en dehors de la liste blanche, et l'erreur `errorCode 309` (« the signature is invalid ») lorsque le HMAC a été mal construit ou que le secret a été copié avec des espaces. L'erreur `errorCode 304` couvre les écarts d'horodatage ou de fenêtre de validité. Bitvavo recommande de régénérer les clés plutôt que de déboguer les problèmes de nonce ou de copier-coller.
05 · Flux EUR
Financement via SEPA, SEPA Instant et iDEAL
Le dépôt de monnaie fiduciaire s'effectue nativement en EUR via un virement bancaire SEPA gratuit (1 jour ouvrable pour les comptes néerlandais, 2 pour les autres pays de l'EEA), SEPA Instant pour les banques compatibles, et iDEAL jusqu'à 50 000 € par transaction. Les dépôts SEPA récurrents sont également pris en charge. Il n'y a pas de passerelle d'entrée en USD ; les stratégies doivent être libellées en EUR ou accepter l'exposition au risque de change.
SourceBitvavo SEPA deposits06 · Réseaux de dépôt
Un seul réseau par actif, pas de stablecoins TRC-20
Contrairement aux plateformes multi-chaînes, Bitvavo ne prend délibérément qu'un seul réseau blockchain par actif répertorié afin de réduire le risque d'erreur d'envoi. Notamment, les dépôts TRC-20 d'actifs cotés en Ethereum ne sont pas pris en charge. La dérivation de l'adresse de dépôt doit vérifier la liste des réseaux pris en charge par Bitvavo pour chaque actif avant de générer une adresse ; les fonds envoyés par erreur ne peuvent pas être récupérés.
07 · Réglementation
Autorisé par la MiCA via l'AFM, passeport EEA actif
Bitvavo a reçu l'autorisation MiCA de l'AFM néerlandaise en juin 2025, couvrant la conservation, l'exploitation d'une plateforme de négociation et le transfert de crypto-actifs dans tous les États membres de l'UE ainsi qu'en Norvège, en Islande et au Liechtenstein. L'enregistrement antérieur auprès de la DNB reste actif pour la surveillance LCB/FT. La période de transition MiCA pour les CASP non agréés dans la plupart des États membres s'est achevée à la mi-2026 ; l'utilisation d'une plateforme agréée MiCA est désormais la norme de conformité pour les exploitants de stratégies résidant dans l'EEA.
Section 06 · Conçu pour
Conçu pour
Les runtimes TradingHost pour Bitvavo sont particulièrement adaptés aux :
- Développeurs concevant des stratégies dans des IDE IA (Cursor, Claude Code)
- Traders crypto systématiques
- Développeurs quantitatifs basés dans l'UE
- Utilisateurs de CCXT et Freqtrade
- Équipes migrant d'un hébergement VPS vers un déploiement conteneurisé
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é à Bitvavo.
Non. Le code de votre stratégie se connecte à Bitvavo et envoie des instructions selon votre propre logique, les autorisations de votre compte et votre méthode d'intégration. TradingHost fournit l'environnement d'exécution (runtime) où ce code s'exécute.
Non. L'accès à l'API de Bitvavo est fourni par Bitvavo. Vous êtes responsable de votre compte Bitvavo, des autorisations de l'API, de vos identifiants et du respect des conditions d'utilisation de Bitvavo.
Non. TradingHost est l'environnement d'exécution 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éconfigurés. 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 en tant que code, et vous utilisez TradingHost pour l'exécuter en production. Des produits comme 3Commas ou Cryptohopper détiennent la logique de la stratégie ; TradingHost exécute la vôtre.
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 transmission des journaux, la rotation des secrets, le basculement de région et la surveillance de la disponibilité. TradingHost vous offre un environnement d'exécution géré et conçu spécifiquement pour les stratégies de trading : déploiement natif via GitHub, contrôle piloté par MCP depuis vos IDE IA, ainsi que des interfaces de logs et de suivi 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 environnement d'exécution sous forme de service managé, TradingHost est la voie la plus rapide.
Oui. TradingHost exécute des stratégies Python ; choisissez l'environnement d'exécution 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. Bitvavo est pris en charge à la fois dans CCXT et CCXT Pro sous l'identifiant de plateforme bitvavo, couvrant REST et WebSocket. Bitvavo publie également des SDK officiels en Python, Node.js, Go et Java si vous préférez le client natif. Consultez l'environnement d'exécution du framework CCXT pour connaître tous les détails de configuration.
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 environnement d'exécution, ou les séparer dans différents environnements pour des raisons d'isolation et de clarté opérationnelle. Consultez la page de l'environnement d'exécution TradingHost pour découvrir le modèle multi-stratégie.
La méthode la plus rapide consiste à dupliquer (fork) un environnement d'exécution 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. Associer un dépôt GitHub et créer une stratégie est gratuit ; les abonnements d'environnement d'exécution sont détaillés sur la page des tarifs.
Dans votre flux de travail 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 votre clé API et votre secret. Consultez la section sur les secrets de la plateforme pour connaître le modèle complet de gestion.
Non. Les stratégies ne devraient jamais avoir besoin de la portée Withdraw. Utilisez uniquement les portées View et Trade, et activez la liste blanche d'adresses IP lorsque cela est possible. Bitvavo signale que les retraits initiés via l'API contournent la 2FA, la portée Withdraw présente donc un risque élevé et doit être réservée aux clés que vous utilisez manuellement depuis un hôte à IP fixe.
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 logs, redémarrer les stratégies et gérer les flux de travail de l'environnement d'exécution. MCP est une interface de contrôle et d'observabilité, et non le chemin d'exécution des transactions. Consultez l'interface de contrôle MCP pour une vue d'ensemble complète.
Les deux. L'interface 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 GitHub fonctionne également sans aucun outil d'IA : un simple git push sur votre branche principale déclenche un redéploiement.
Le runtime détecte le plantage et expose les journaux (logs) 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 risques. Consultez la section observabilité pour accéder aux logs et à l'interface d'état.
Il s'agit d'un rejet lié à la liste blanche d'adresses IP de Bitvavo. Ajoutez l'adresse IP de sortie (egress IP) du runtime TradingHost à la liste blanche de la clé API dans le tableau de bord Bitvavo, ou régénérez la clé sans liste blanche (non recommandé). Confirmez l'adresse IP de sortie via les informations de runtime de TradingHost avant de l'ajouter à la liste blanche.
La signature HMAC a été mal construite ou le secret de l'API a été copié avec un espace indésirable. Recalculez la signature sous forme de condensé hexadécimal HMAC-SHA256(secret, timestamp + method + url + body), assurez-vous que la chaîne du corps de la requête correspond exactement à ce qui est signé, et vérifiez que Bitvavo-Access-Timestamp est exprimé en millisecondes et s'inscrit dans la fenêtre Bitvavo-Access-Window. Régénérer la clé est la solution la plus rapide si le secret est corrompu.
Non. Bitvavo propose uniquement du trading au comptant (spot) avec un levier de 1:1 ; il n'y a pas de contrats à terme, de perpétuels, d'options ni de produit sur marge. Pour les perpétuels ou les contrats à terme USD-M, déployez une stratégie distincte sur Binance, Bybit ou OKX.
Oui. Bitvavo est agréé sous le régime MiCA par l'AFM néerlandaise (juin 2025) et enregistré auprès de De Nederlandsche Bank depuis 2020. L'agrément MiCA bénéficie d'un passeport européen dans tout l'EEA, ce qui permet à un opérateur de stratégie résidant dans l'EEA d'héberger sa stratégie sur une plateforme agréée sans avoir à s'enregistrer séparément dans chaque pays. Bitvavo est un CASP, pas un établissement de crédit ; cela n'étend pas les protections MiFID aux activités de trading.
En EUR par virement bancaire SEPA gratuit (1 à 2 jours ouvrables), SEPA Instant si votre banque le prend en charge, ou iDEAL pour des recharges instantanées depuis une banque néerlandaise jusqu'à 50 000 € par transaction. Il n'y a pas de passerelle fiduciaire en USD ; un PnL libellé en USD nécessite une conversion en stablecoin ou en devises.
TradingHost est disponible dans les régions EU et US-East. Pour Bitvavo spécifiquement, la région EU est la plus proche géographiquement du moteur de matching de Bitvavo, situé près d'Amsterdam, et offre généralement la latence aller-retour la plus faible. Consultez la page des régions pour obtenir plus de détails sur le routage et la proximité.
Non. TradingHost se concentre exclusivement sur l'exécution en production et le déploiement. Le backtesting relève de votre infrastructure de recherche, de votre framework ou d'AlgoBuilder.