Tutoriels

Création et configuration d'un robot de trading

 

Apprends à créer un bot de trading avec l'API Cryptohopper et à modifier la configuration de ton ou tes bots de trading. En 2 étapes simples, nous allons créer un nouveau bot de trading et ajouter des paramètres de configuration au bot de trading nouvellement créé.

Pour faire des requêtes API, tu devras créer une appli et avoir un jeton d'accès. Si tu n'as pas encore créé de jeton d'accès, suis d'abord le tutoriel Obtenir un jeton d'accès avec Oauth2.

Étape 1 : Créer un nouveau bot de trading

Pour créer un nouveau bot de trading avec l'API, tu devras faire un appel POST à l'endpoint hopper. Avec l'appel POST, tu peux envoyer directement des valeurs de configuration, mais dans cet exemple, nous n'enverrons que quelques exemples de configuration et configurerons le bot de trading à l'étape suivante. Ci-dessous, tu trouveras l'endpoint de l'API et le JSON que tu devras envoyer avec la requête POST.

Endpoint de l'API :

https://api.cryptohopper.com/v1/hopper

JSON POST :

{
    "name": "Le nom de ton bot de trading nouvellement créé.",
    "enabled": 0
}

Lorsque la requête API sera réussie, tu recevras une réponse JSON avec la valeur : id. Cet id est l'identifiant unique de ton bot de trading nouvellement créé. Enregistre l'id, car nous en aurons besoin à l'étape suivante pour ajuster la configuration du bot de trading.

Étape 2 : Configure ton bot de trading

Maintenant que nous avons créé un nouveau bot de trading et que tu as l'id du bot de trading nouvellement créé, il est temps de configurer le bot de trading afin que tu puisses commencer à trader automatiquement avec lui. Toutes les mises à jour de ton bot de trading se feront en accédant aux endpoints du bot de trading avec ton id, comme /hopper/{id}. Pour mettre à jour la configuration de ton bot de trading, tu vas devoir faire une requête PATCH à cet endpoint. Ci-dessous, tu trouveras l'endpoint vers lequel tu devras envoyer ta requête PATCH. Remplace {id} par l'id que tu as reçu à l'étape 1.

Endpoint de l'API :

https://api.cryptohopper.com/v1/hopper/{id}

Tu devras envoyer des données JSON des mises à jour que tu souhaites effectuer. Si tu souhaites modifier le nom de ton bot de trading par exemple, tu devras renvoyer la clé name. Si tu ne souhaites pas modifier le nom, tu peux simplement omettre ce champ. Ci-dessous, tu trouveras un exemple de requête JSON PATCH.

Exemple de requête JSON PATCH :

{
    "name": "Un nouveau nom pour ton bot de trading nouvellement créé.",
    "enabled": 0,
    "api_config": {
    "api_key": "La clé API de ton compte d'échange.",
    "api_secret": "Le secret API de ton compte d'échange."
    },
    "config": {
    "exchange": "binance",
        "collect_currency": "btc",
        .... Et plus d'options de configuration
    }
}

Passons en revue quelques-unes des options de configuration possibles dans la requête JSON.

api_config
api_key C'est la clé API que tu as créée sur ton exchange.
api_secret C'est le secret API que tu as créé sur ton exchange.
config
exchange Entre la clé d'échange de l'exchange que tu souhaites connecter. Pour obtenir une liste de tous les exchanges et clés, va sur : https://api.cryptohopper.com/v1/exchange
collect_currency C'est la devise de cotation de ton bot de trading en minuscules, par exemple : btc, usd, eth.
allowed_coins Une liste de tableaux de pièces (en majuscules) que le bot de trading peut acheter automatiquement. Par exemple : ["BTC", "LTC", "ETH"].
perc_buy_amount Le pourcentage de tes actifs totaux qui sera utilisé pour déterminer le montant de l'achat.
min_buy_amount Le montant minimum d'achat des achats automatiques.
max_amount_allocated Le montant maximum (en devise de cotation) alloué à ton bot de trading.
strategy La stratégie que tu souhaites configurer. Par exemple : no_strategy, multiple_ta. Si tu souhaites configurer une stratégie personnalisée, tu devras avoir l'id de la stratégie et la configurer comme suit : user_{id}, par exemple : user_1.
num_targets_per_buy Le nombre de cibles qui seront achetées si plusieurs cibles sont trouvées par ta stratégie.
max_open_time_buy Le nombre de minutes pendant lesquelles les ordres d'achat peuvent rester ouverts avant d'être automatiquement annulés.
max_open_time Le nombre de minutes pendant lesquelles les ordres de vente peuvent rester ouverts avant d'être automatiquement annulés.
set_percentage Le pourcentage de prise de bénéfices que tu souhaites configurer, par exemple : 1.5.

Bien sûr, il existe de nombreuses autres options de configuration. Consulte la référence de l'API pour plus d'informations sur l'objet config.

Lorsque tu as correctement mis à jour la configuration de ton bot de trading, tu recevras une réponse 200 avec ton objet config complet renvoyé. Si la requête a échoué, tu recevras un statut 400 avec un message d'erreur expliquant l'erreur.

J'espère que tu as réussi à créer et à configurer ton bot de trading après avoir lu ce tutoriel. Tu vas maintenant pouvoir ajuster la configuration de ton bot de trading et ajouter de nouveaux bots de trading à ton compte.