La connexion à Bitvavo passe par Gustav Connect, notre propre solution de synchronisation.
Vous avez simplement besoin d'un compte Bitvavo vérifié avec l'authentification à deux facteurs (2FA) activée, puis de générer une clé API depuis votre espace Bitvavo.
Pas besoin de partager vos identifiants : la clé API permet uniquement à Gustav de consulter vos données.
Pour en savoir plus sur Gustav Connect et son fonctionnement, consultez l'article Qu'est-ce que Gustav Connect ?.
Étape 1 : Créer une clé API sur Bitvavo
Connectez-vous à Bitvavo.
Ouvrez le menu en cliquant sur votre nom en haut à droite et cliquez sur Paramètres.
Allez dans l'onglet API.
Cliquez sur Ajouter une nouvelle clé API et donnez-lui un nom (par exemple "Gustav") pour la retrouver facilement.
Dans les permissions, activez Accès en lecture (View access). Laissez les autres permissions désactivées.
Cliquez sur Générer une clé API, puis saisissez votre mot de passe et votre code 2FA pour confirmer.
Bitvavo vous envoie un email de confirmation. Cliquez sur le lien dans l'email pour activer votre clé.
La permission Accès en lecture donne uniquement un accès en consultation. Gustav ne pourra jamais passer d'ordres, effectuer de retraits ni modifier quoi que ce soit sur votre compte.
Étape 2 : Copier vos clés dans Gustav
Une fois la clé activée, Bitvavo affiche deux informations : l'API Key et le Secret. Copiez le Secret immédiatement, il ne sera plus affiché par la suite.
Dans Gustav, allez dans Compléter mon patrimoine > Crypto-monnaies > Synchronisation automatique.
Recherchez et sélectionnez Bitvavo.
Collez votre clé API et votre Secret dans les champs correspondants, puis cliquez sur Se connecter à mon compte.
Gustav vérifie immédiatement vos clés et lance la première synchronisation.
Quelles données sont synchronisées ?
Une fois connecté, Gustav récupère automatiquement :
Vos positions crypto : chaque cryptomonnaie est identifiée et rattachée à son cours actuel, avec la valorisation en euros.
Votre solde en euros : les liquidités disponibles sur votre compte Bitvavo.
Vos transactions : tous vos achats et ventes exécutés, y compris les conversions entre cryptomonnaies.
Vos dépôts et retraits : les mouvements entrants et sortants de votre compte.
Les données se mettent à jour automatiquement, vous n'avez plus rien à faire 😉
Vous pouvez aussi déclencher une synchronisation manuelle à tout moment depuis la fiche du compte.
Pour garantir une connexion stable avec Bitvavo, un délai de 2 heures est appliqué entre chaque synchronisation manuelle.
En cas de problème
Gustav affiche "Les clés API ont été révoquées" ou "Des permissions sont manquantes sur votre clé API".
Votre clé API n'est plus valide ou ne dispose pas des bonnes permissions.
Supprimez le compte Bitvavo dans Gustav, puis refaites la procédure avec une nouvelle clé API en suivant les étapes ci-dessus.
Gustav affiche "Identifiants incorrects. Veuillez vérifier vos informations et réessayer."
Vérifiez que vous avez bien copié les deux clés (API Key et Secret). Assurez-vous aussi que la clé a bien été activée via l'email de confirmation de Bitvavo.