Comment créer un bot de trading pour Binance Futures avec Node.js

 npm i dotenv axios ws

Le module dotenv sert à charger les variables d’environnement dans votre application Node.js. Nous utiliserons ces variables d’environnement pour définir les configurations de notre bot. Créez un fichier “.env” à la racine de votre projet avec le contenu suivant, représentant les configurations dont nous allons avoir besoin :

 API_URL=
STREAM_URL=
API_KEY=
SECRET_KEY=

Voici une explication rapide de la façon dont vous devez remplir chaque variable après le signe égal :

• API_KEY : votre clé API de futures, créée sur Binance ;
• SECRET_KEY : votre secret API de futures, créé sur Binance ;
• API_URL : l’adresse de base de l’API Binance que vous allez utiliser, vous pouvez mettre https://fapi.binance.com/fapi si vous travaillez en production ou https://demo-fapi.binance.com/fapi si vous travaillez en environnement de test ;
• STREAM_URL : l’adresse de base des streams de Binance que vous allez utiliser, vous pouvez mettre
  wss://fstream.binance.com/market/ws (prod) ou wss://fstream.binancefuture.com/market/ws (demo)

Gardez à l’esprit que les informations API_KEY et SECRET_KEY sont secrètes et que vous ne devez les partager avec personne, sinon quiconque les découvre pourra acheter et vendre des cryptomonnaies en votre nom, en utilisant votre argent.

Si vous prévoyez de versionner votre projet ou même de partager votre code avec d’autres personnes via Git, mettez un .gitignore à la racine de votre projet en incluant le dossier node_modules (par défaut) et le fichier .env, qui est conservé localement uniquement dans votre projet.

Pour charger ces configurations dans votre application, modifiez votre fichier package.json afin que le script de démarrage charge le .env et je vais aussi ajuster le type du projet pour utiliser la syntaxe moderne du JS :

 "type": "module",
"scripts": {
  "start": "node -r dotenv/config index"
},

Notez qu’il vous appartient de comprendre les meilleurs réglages pour vos objectifs financiers, votre situation financière, l’état du marché des cryptomonnaies au moment où vous opérez, etc. Je me concentrerai ici sur la construction du robot qui surveille, ouvre et ferme des positions sur le marché à terme, pas sur votre configuration.

#3 – Surveillance du marché

Commençons par la première activité, qui est la plus simple et qui constitue la base du robot : surveiller le marché. Il existe plusieurs façons de procéder, mais celle que je considère comme la meilleure passe par les flux de données. Les flux de données, ou flux d’information, sont des canaux que Binance met à disposition pour brancher votre bot et recevoir en temps réel le type d’information que vous souhaitez. La documentation complète et à jour de l’API et des flux des futures de Binance peut être consultée ici.

Pour se connecter aux flux, nous utilisons une technologie appelée WebSocket, native à JavaScript, que nous allons exploiter via la bibliothèque ws que nous avons installée précédemment. Ouvrez votre fichier index.js, importez la classe WebSocket du paquet ws et utilisez-la pour vous connecter au stream de Ticker selon l’URL indiquée dans la documentation. Cette connexion vous permet d’« écouter » un événement onmessage du WebSocket qui vous transmet, à chaque fois, diverses données du couple de devises que vous souhaitez surveiller (BTCUSDT dans l’exemple), comme son prix actuel.

import WebSocket from "ws";
const ws = new WebSocket(`${process.env.STREAM_URL}/btcusdt@ticker`);

ws.onmessage = (event) => {
    console.clear();
    const obj = JSON.parse(event.data);
    console.log(`Symbol: ${obj.s}`);
    console.log(`Price: ${obj.c}`);
}

L’événement onmessage déclenche une fonction à chaque fois que Binance vous envoie une mise à jour. Dans cette fonction, vous pouvez faire ce que vous voulez et, dans cet exemple, je nettoie le terminal sur la première ligne (par souci d’organisation) puis je convertis l’event.data, qui est initialement une chaîne, en un objet JSON et ne récupère que deux informations : la paire de devises (propriété s) et le prix actuel (propriété c).

Essayez d’exécuter ce projet après avoir enregistré le fichier et lancez la commande npm start pour voir en temps réel l’arrivée du prix.

Pour finaliser la surveillance, vous pouvez ajouter dans la fonction de l’événement onmessage votre logique de négociation, avec des entrées et sorties basées sur l’information dont nous disposons, à savoir le prix. Un exemple purement didactique ci-dessous, où nous avons une logique pour ouvrir notre position (indiquez un prix qui vous semble cohérent) et une autre logique pour la fermer; rappelez-vous que sur le marché à terme, vous pouvez ouvrir des positions acheteur ou vendeur, donc les prix n’ont pas obligatoirement à suivre la logique du plus élevé au plus bas, cela peut être l’inverse selon votre stratégie.

 const price = parseFloat(obj.c);
if (price < 100000)
    console.log('Ouvrir position !');
else if (price > 110000)
    console.log('Fermer position !');

Il peut aussi être utile de disposer d’un mécanisme de contrôle pour éviter d’acheter de façon répétée ou de vendre de façon répétée. Cela peut être facilement géré en déclarant une variable en dehors de la fonction onmessage et en la modifiant au sein des conditions des if, comme ci-dessous.

let isOpened = false;

ws.onmessage = (event) => {
    ...

    const price = parseFloat(obj.p);
    if (price < 100000 && !isOpened) {
        console.log('Ouvrir position !');
        isOpened = true;
    }
    else if (price > 110000 && isOpened) {
        console.log('Fermer position !');
        isOpened = false;
    }
}
 

En utilisant ces valeurs et en les comparant à vos objectifs d’achat ou de vente, le robot peut vous avertir, par exemple par e-mail (ou aussi par SMS, WhatsApp ou Telegram) qu’il est temps d’acheter ou de vendre. Bien sûr, dans un scénario idéal et plus complet, le robot pourrait effectuer ces opérations lui-même, ce qui est tout à fait possible à développer.