đŸ€– Freqtrade + Hyperliquid : Le Guide Co ...

đŸ€– Freqtrade + Hyperliquid : Le Guide Complet pour dĂ©butant

Jul 12, 2025
1766

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 đŸ’Ș)

GefÀllt dir dieser Beitrag?

Kaufe Freqtrade France einen Kaffee

Mehr von Freqtrade France