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 :
Fichier d'accĂšs exchange : _hyperliquid_freqtrade_access.json
Fichier base commune : _default_spot_usdc.json
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)
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) đ
Va sur hyperliquid.xyz â Connect Wallet (MetaMask, RabbyâŠ), tu peux aussi te connecter simplement avec un email.
Menu Settings â API Wallets â + New API Wallet
Copie & colle les clés dans
_hyperliquid_freqtrade_access.jsonDĂ©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Ă©ralstake_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ĂŽttrading_mode: "futures"+margin_mode: "isolated": perpĂ©tuels USDC sĂ©curisĂ© par paireunfilledtimeout.entry: 10: si la limite n'est pas prise en 10 min, on annuleentrypricing.orderbook_top: 1: prend le meilleur bid/ask
đ _hyperliquid_freqtrade_access.json
exchange.name: "hyperliquid": dispo depuis Freqtrade â„ 2024.xwalletAddress / privateKey: API Wallet d'Hyperliquidapi_server.jwt_secret_key / ws_token: choisis des chaĂźnes longues đ, communes Ă tous tes bots liveCORS_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 basemax_open_trades: 8: divise auto le solde en 8pairlists.VolumePairList: top 80 volumes sur 24h â impossible en backtest, uniquement livedb_url: un fichier .sqlite par bot pour sĂ©parer l'historiqueinternals.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
orderbooktopou augmenteunfilledtimeout.entryHyperliquid 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 đȘ)

