Polymarket Bot Tutorial · Chapitre 31 sur 32
Passer votre bot Polymarket en production : premier dépôt de 25-50 USD, règles de take-profit et stop-loss, seuils d’alerte (Telegram/email), cadence de reconciliation et plan de montée en charge pour la première semaine.
Ce que ce chapitre couvre
La transition du paper au live est l’endroit où la plupart des builders perdent accidentellement leur premier dépôt. Ce chapitre est la checklist de pré-vol, plus la discipline de la première semaine qui détecte les bugs avant qu’ils ne deviennent des pertes.
- Checklist de pré-vol
- Premier dépôt: 25-50 USD
- Règles TP/SL issues de la production
- Monitoring: Telegram, email, dashboards
- Cadence de reconciliation: à chaque cycle de fire_exits
- Première semaine: rester proche, rester petit
- Scaling: quand déposer davantage
Checklist de pré-vol
La liste exacte, dans l’ordre, avant de faire passer le bot du paper au live.
- 30 paper trades clôturés. Critères de réussite rédigés atteints ou dépassés.
- Format de diary identique entre paper et live. Même schéma JSONL.
- VPS déployé. Le bot est le seul process ; unité systemd configurée.
- Mécanisme de fichier HALT testé.
touch /opt/pmt/HALTarrête le bot en moins de 30 secondes. - Alertes Telegram configurées. Une alerte de test est envoyée avec succès.
- Kill switch de daily-loss testé. Simulez un drawdown de 10 % ; vérifiez que le halt se déclenche.
- Reconciliation on-chain testée. Faites volontairement diverger le diary ; vérifiez que le halt se déclenche.
- L’adresse de dépôt est le proxy wallet - le portefeuille à contrat intelligent depuis lequel Polymarket trade pour votre compte (POLY_FUNDER_ADDRESS) - et non votre compte personnel, c’est-à-dire l’externally-owned account ou EOA. Vérifié via la commande SDK
wallet show. - Approvals USDC/pUSD définis. Pour l’exchange standard et l’exchange NegRisk.
- Montant du dépôt initial convenu par écrit: 25-50 $ pour le smoke test.
Si un seul élément est incomplet, ne passez pas en live. Chacun d’eux a coûté de l’argent réel à un builder dans de précédents retours de production.
Premier dépôt: 25-50 USD
Le dépôt de smoke test est volontairement petit. L’objectif est de vérifier que le chemin live fonctionne, pas de gagner de l’argent.
Ce que vous testez: est-ce que le placement des ordres du bot correspond à la vue de Polymarket sur le trade. Est-ce que le diary enregistre correctement. Est-ce que le take-profit GTC est réellement posté. Est-ce que le bot se remet d’une erreur API transitoire. Est-ce que le halt de daily-loss se déclenche si vous en simulez un.
Résultat attendu: 5-15 petits trades qui reflètent à peu près le diary paper. Considérez tout écart comme un bug, pas comme une caractéristique du fait que le live soit « plus bruité que le paper ».
Si vous perdez ces 25-50 $ sur une vraie perte de stratégie, il faut davantage de paper runs. Si vous les perdez à cause de bugs, corrigez les bugs avant de scaler.
Règles TP/SL issues de la production
D’abord deux définitions rapides, car cette section s’appuie dessus. Un take-profit (TP) est un ordre de vente pré-réglé qui verrouille un gain dès que le prix atteint votre objectif ; un stop-loss (SL) vend la position dès que le prix franchit une limite, pour qu’un seul mauvais trade ne parte pas en vrille. Les deux types d’ordres utilisés ci-dessous sont le GTC (Good-Til-Cancelled, un ordre passif qui attend dans le carnet jusqu’à être exécuté ou annulé par vous) et le FOK (Fill-Or-Kill, qui exécute l’ordre entier instantanément ou l’annule complètement). Un autre terme que vous rencontrerez, mark, n’est pas du tout un type d’ordre - il désigne simplement le mid-price actuel par rapport auquel vous évaluez la position. Voici les paramètres par défaut de production de notre trader, qui ont tenu sur des milliers de trades.
- Buy: FOK 1c au-dessus du meilleur ask. Ignorez le trade si l’ask dépasse 0.85 - c’est « le piège du 0.99 » : un marché quasiment joué, coté à 0.90+, offre un potentiel de hausse minuscule mais chute brutalement s’il se retourne ; le rapport risque/rendement est donc inversé.
- Take-profit: sell GTC à entry + 4-6c, placé immédiatement après le fill du buy + attente de settlement de 5s.
- Stop-loss via mark: surveiller le mid; si le mid descend à entry - 8c, sell FOK au meilleur bid (pas de resting; un passage rapide sous le mid se produit vite).
- Time exit: si la position n’est pas clôturée dans X heures et que le PnL est entre -2c et +2c, sortie FOK au market.
Les chiffres varient selon la stratégie, mais le schéma reste le même: le take-profit est toujours GTC, le stop-loss est généralement FOK (car les stop GTC ne se fill pas lorsque le mid traverse brutalement), et les time exits évitent de rester exposé sur des signaux périmés.
Monitoring: Telegram, email, dashboards
Le bot doit être observable en temps réel. Trois couches.
- Alertes Telegram: chaque fill, chaque halt, chaque erreur au-dessus du seuil. Utilisez un channel ou un groupe dédié; ne mélangez pas avec vos messages personnels.
- Email de résumé quotidien: en fin de journée, total des trades, win rate, PnL, liste des halts déclenchés. Lisez-le chaque matin.
- Dashboard: optionnel mais utile. Un simple endpoint HTTP qui lit le diary et affiche les positions ouvertes + les fills récents + le PnL cumulé.
Le schéma: tout changement d’état qui mérite d’être connu → Telegram. Résumé de fin de journée → email. Exploration en temps réel → dashboard.
Cadence de reconciliation: à chaque cycle de fire_exits
La reconciliation doit s’exécuter suffisamment souvent pour que le drift soit détecté avant que le trade suivant ne l’amplifie. La cadence dépend de la fréquence de trading.
- Stratégies avec < 10 trades/jour: reconcile toutes les heures.
- Stratégies avec 10-100 trades/jour: reconcile toutes les 15 minutes.
- Stratégies HFT (100+ trades/jour): reconcile à chaque cycle de la boucle de sortie.
Le coût de la reconciliation correspond à une lecture on-chain par token détenu. Avec 20 tokens, cela fait 20 appels RPC ; sur un RPC en free-tier, on reste largement dans le budget. Ne sur-optimisez pas cela.
Première semaine: rester proche, rester petit
La première semaine de déploiement live est la plus dangereuse. Vous découvrez des bugs du chemin live que l’exécution paper n’a pas révélés. Discipline:
- Restez proche - vérifiez le channel Telegram toutes les heures pendant vos heures d’éveil.
- Restez petit - tailles de position au minimum (5 shares); un bug doit coûter des dollars, pas des centaines.
- Reconcile manuellement en fin de journée pendant les 3 à 5 premiers jours. Comparez directement le diary à l’interface Polymarket.
- Documentez chaque surprise. Même de petites incompréhensions finissent un jour par devenir des bugs.
Fin de la première semaine: si aucun bug n’apparaît et que le diary correspond à la réalité, passez à la taille normale. Si des bugs sont apparus, corrigez-les, puis lancez une nouvelle semaine de smoke test.
Scaling: quand déposer davantage
Déclencheurs pour ajouter du capital, chacun avec un seuil différent.
- +50% de dépôt: 30 live trades, win rate à moins de 5 pts du taux paper, aucun halt de production dû à un bug.
- +100-200% de dépôt: 100+ live trades, rentabilité régulière sur l’échantillon, infrastructure testée au moins lors d’une panne mineure.
- +500%+ de dépôt: seulement après 6 mois ou plus de rentabilité live régulière. Le capital augmente plus lentement que le succès - vous voulez être sûr que l’edge est réel, pas qu’il s’agit d’un régime sur le point de disparaître.
Le plus grand risque unique d’un scaling prématuré: une stratégie rentable dans un régime de marché devient non rentable dans le suivant. Une taille plus grande ne corrige pas cela. La patience, si.
