Inicio
Membresía
Publicaciones
Galería
Freqtrade France
Publicaciones
🤖 Freqtrade + Hyperliquid : Le Guide Co ...

🤖 Freqtrade + Hyperliquid : Le Guide Complet pour débutant

Jul 12, 2025

image

Parce qu'un bot bien rangé, c'est déjà un bot plus rentable !

Objectif : t'expliquer la structure recommandée (3 fichiers) + le branchement à Hyperliquid, le DEX le plus adapté à Freqtrade aujourd'hui !

Et si tu ouvres ton compte avec mon lien ➜ https://app.hyperliquid.xyz/join/MOUTON : ça fait une réduction de frais à tous les deux, c'est pas grand chose mais ça donne le sourire :)

🎯 Pourquoi Hyperliquid plutôt que Binance ?

Hyperliquid vs Binance pour Freqtrade :

✅ Hyperliquid :

  • Frais ultra-bas (0.02% maker, 0.05% taker)

  • Pas de KYC requis

  • API simple et fluide

  • Liquidité décente sur les principales paires

  • Parfait pour débuter avec des petits montants

❌ Binance :

  • KYC obligatoire + restrictions géographiques

  • Frais plus élevés (0.10% spot)

  • API plus complexe

  • Risque de ban/suspension de compte

Pour débuter avec Freqtrade, Hyperliquid est clairement le choix le plus simple !

📋 Structure recommandée (3 fichiers)

Je vais te montrer en tant que débutant comment utiliser proprement Hyperliquid avec Freqtrade. Vous pouvez évidemment structurer vos fichiers de configurations autrement, mais voici une structure simple que j'utilise depuis plusieurs années et qui me paraît très adaptée aux novices.

⚠️ Attention, cette structure est idéale uniquement si :

  • Tu ne comptes faire que des positions longs en levier x1 (pas de levier)

  • Tu n'as qu'un seul compte Hyperliquid sans accès aux sous-comptes (accessibles à partir de 100k$ de volume)

  • Tu souhaites mettre tout ton capital sur ton compte Hyperliquid avec une portion fixe par bot

Exemple : Tu as 1000 USDC et chaque bot peut utiliser 200 USDC pour ouvrir/fermer ses positions.

📂 Les fichiers à télécharger

Télécharge directement les configs depuis le repo de la dernière stratégie présentée par exemple :

  1. Fichier d'accès exchange : _hyperliquid_freqtrade_access.json

  2. Fichier base commune : _default_spot_usdc.json

  3. Exemple de stratégie : simple_vwap_v1.json

    Tous ces fichiers doivent être placés dans freqtrade/live_configs/

1️⃣ Pourquoi trois fichiers au lieu d'un seul ? 🤔

📂 1. Fichier d'accès exchange

_hyperliquid_freqtrade_access.json

Modifie ce fichier uniquement quand tu changes d'exchange, autrement tu peux garder ce fichier pour tout tes bots hyperliquid !

{
  "exchange": {
    "name": "hyperliquid",
    "walletAddress": "0x...",
    "privateKey": "0x..."
  },
  "api_server": {
    "jwt_secret_key": "...",
    "ws_token": "..."
  }
}

🔑 Wallet + clé privée Hyperliquid — et basta.

🧱 2. Fichier « base » (template)

_default_spot_usdc.json

Tout ce qui est commun à tous tes bots live qui utilise une base en USDC.

{
  "stake_currency": "USDC",
  "trading_mode": "futures",
  "tradable_balance_ratio": 0.95,
  "stake_amount": "unlimited"
}

🔥 3. Fichier stratégie

simple_vwap_v1.json (exemple, pensez à changer le nom avec le nom de chaque stratégie pour vous y retrouvez)

Dans ce fichier on va retrouver qui est spécifique à un bot : nom, base SQLite, ports, max_open_trades, combien d'USDC il est autorisé à utiliser, etc.

{
  "add_config_files": [
    "_default_spot_usdc.json",
    "_hyperliquid_freqtrade_access.json"
  ],
  "bot_name": "simple_vwap_v1_hyperliquid_spot",
  "strategy": "simple_vwap_v1",
  "max_open_trades": 8,
  "available_capital": 200
}

🎁 Avantages de cette approche

  • Facile de dupliquer : copie le fichier stratégie, change bot_name, strategy, listen_port, db_url ➜ nouveau bot prêt !

  • Sécurisé : la clé privée reste dans UN seul fichier, c'est le seul que tu ne dois pas partager (_hyperliquid_freqtrade_access.json) car ça permet au minimum d'aller faire des transactions avec ton compte.

  • Maintenance simplifiée : un changement dans la base = tous les bots mis à jour

2️⃣ Arborescence conseillée 🗂️

freqtrade/
├─ live_configs/
│   ├─ _hyperliquid_freqtrade_access.json   # ① accès exchange
│   ├─ _default_spot_usdc.json             # ② base commune
│   ├─ simple_vwap_v1.json                 # ③ stratégie 1
│   ├─ phoenix_rsi_v1.json                 # ③ stratégie 2
│   └─ double_vwap_v1.json                 # ③ stratégie 3
├─ strategies/
│   ├─ simple_vwap_v1.py
│   └─ phoenix_rsi_v1.py
└─ backtest_configs/                       # 100% backtest
    ├─ USDC_all_hyperliquid.json
    └─ USDT_all_binance.json

⚡️ Séparer live / backtest évite 99% des erreurs de lancement.

3️⃣ Créer ton compte Hyperliquid (2 min chrono) 🏁

  1. Va sur hyperliquid.xyz ➜ Connect Wallet (MetaMask, Rabby…), tu peux aussi te connecter simplement avec un email.

  2. Menu Settings → API Wallets → + New API Wallet

  3. Copie & colle les clés dans _hyperliquid_freqtrade_access.json

  4. Dépose un peu d'USDC (réseau Arbitrum) ✨

🆘 Perds pas la clé privée : sinon il faudra recréer l'API Wallet (c'est pas si chiant mais, évitons quand même)

4️⃣ Anatomie des fichiers (ligne par ligne) 🩺

✨ default_spot_usdc.json

  • stake_currency: "USDC" : Hyperliquid bosse en USDC collatéral

  • stake_amount: "unlimited" : ré-investit 100% du solde ➜ compounding, MAIS lis le post sur le risque !

  • tradable_balance_ratio: 0.95 : utilise max 95% du wallet (buffer frais + slippage)

  • available_capital: 100 : valeur virtuelle pour le sizing interne — pas un dépôt

  • trading_mode: "futures" + margin_mode: "isolated" : perpétuels USDC sécurisé par paire

  • unfilledtimeout.entry: 10 : si la limite n'est pas prise en 10 min, on annule

  • entrypricing.orderbook_top: 1 : prend le meilleur bid/ask

🚀 _hyperliquid_freqtrade_access.json

  • exchange.name: "hyperliquid" : dispo depuis Freqtrade ≥ 2024.x

  • walletAddress / privateKey : API Wallet d'Hyperliquid

  • api_server.jwt_secret_key / ws_token : choisis des chaînes longues 🔐, communes à tous tes bots live

  • CORS_origins : IP de ta FreqUI si tu en as une

🔥 simplevwapv1.json

  • add_config_files : l'ordre est important ➜ la stratégie peut écraser la base

  • max_open_trades: 8 : divise auto le solde en 8

  • pairlists.VolumePairList : top 80 volumes sur 24h → impossible en backtest, uniquement live

  • db_url : un fichier .sqlite par bot pour séparer l'historique

  • internals.process_throttle_secs: 60 : un cycle/minute = assez pour 1h, 4h, 1d chandelles

5️⃣ Stratégie exemple 🧠

Tu peux utiliser ma stratégie Simple VWAP disponible ici : simple_vwap_v1.py (la config dans l'exemple est adaptée à cette stratégie)

Cette stratégie :

  • Achète quand le prix franchit la VWAP par le haut

  • Vend quand le prix repasse sous la VWAP

  • Simple et efficace pour débuter !

6️⃣ Lancement 🏎️

# activer l'environnement
source .venv/bin/activate

# go go go!
freqtrade trade -c live_configs/simple_vwap_v1.json

Tu devrais voir : Exchange hyperliquid – Balance: 99.0 USDC – 8/8 trades libres

Utilise freqtrade status ou FreqUI pour suivre les positions.

Nous verrons dans un poste à venir comment lancer la stratégie dans un screen pour qu'elle reste allumée en permanence.

7️⃣ Gérer plusieurs bots avec un seul wallet 🪙

Contexte 🤓

Hyperliquid ne propose pas encore les sous-comptes à tout le monde (il faut faire 100k$ de volume). Le plus simple est donc de faire tourner plusieurs bots sur le même solde.

1. Disponible vs proportionnel

🔢 available_capital (montant fixe) : réserve, par ex., 75 USDC par bot ; stable, indépendamment des gains/pertes des autres.

Tip : Sur un portefeuille de 1000 USDC, mieux vaut définir "available_capital": 75 par bot que jouer au pourcentage.

2. Longs uniquement (recommandé)

Futures : Le plus simple au début est de faire uniquement des Longs en levier 1 jusqu'à débloquer les sous-comptes.

Si tu veux absolument faire des shorts, crée un autre compte Hyperliquid dédié.

3. Extrait minimal à copier/coller 📋

{
  "max_open_trades": 8,
  "available_capital": 75,
  "tradable_balance_ratio": 0.99,
  "stake_amount": "unlimited",
  
  "bot_name": "simple_vwap_v1_hyperliquid_spot",
  "strategy": "simple_vwap_v1",
  "db_url": "sqlite:///database/simple_vwap_v1_hyperliquid_spot.sqlite",
  
  "api_server": { "listen_port": 9020 }
}

💡 Dans 90% des cas, c'est la seule section que tu modifies quand tu dupliques un bot : montant, nom, port, base SQLite.

8️⃣ Séparer backtest & live 🔍

📁 Place les fichiers backtest dans backtest_configs/ 🚫 NE mets pas les clés privées dans ces fichiers 🏷️ Renomme-les clairement (USDC_50_pairs_hyperliquid.json)

9️⃣ FAQ express 🙋‍♂️

« Pourquoi pas un seul gros fichier ? » Parce que :

  • Risque d'erreur (copier une clé privée sur GitHub)

  • Maintenance (changer un paramètre = 5 fichiers à éditer)

  • Scalabilité

« Je veux un bot USDT sur Binance » Crée _binance_freqtrade_access.json + default_spot_usdt.json + stratégie.

« Mes ordres ne passent pas »

  • Hyperliquid a peu de profondeur ➜ réduis orderbooktop ou augmente unfilledtimeout.entry

  • Hyperliquid n'ouvre des positions que si elles sont d'au moins 15 USDC

  • Hyperliquid ne ferme des positions que si elles sont d'au moins 10 USDC

🔟 Conclusion & prochain pas 🏁

En séparant accès, base et stratégie, tu t'offres un setup :

✅ plus propre

✅ plus sûr

✅ plus facile à dupliquer

Hyperliquid complète le tableau avec des frais riquiqui et une API fluide – parfait pour expérimenter tes premiers bots Freqtrade.

Post débutant friendly – partage si ça t'a aidé, et pose tes questions en commentaire 📣

(Et n'oublie pas : toujours commencer en dry-run, le temps de tout comprendre 💪)

¿Te gusta esta publicación?

Comprar Freqtrade France un café

Más de Freqtrade France

    Item 1 of 1
    PrivacidadCondicionesDenunciar
    Empieza tu página de Buy Me a Coffee