Guide Quant Polymarket CLOB : Déployer un bot de copié-trading de baleines et maker sans frais de 0 % avec py-clob-client
Parcours d'ingénierie complet : dériver les identifiants Polygon L2 CLOB, interroger les ID de jetons de conditions Gamma, s'abonner aux exécutations des baleines et passer des ordres limites EIP-712 sans frais de gaz et sans frais de 0 %.
Check-list de pré-vol de 3 minutes pour les débutants
- ✓Ordinateur Windows/Mac ou VPS Ubuntu à 5 $/mois avec Python 3.10 ou supérieur installé
- ✓Un sous-sacchet dédié dans le portefeuille Web3 OKX ou MetaMask (n'utilisez jamais votre coffre-fort principal)
- ✓50 $ à 200 $ en USDC natif sur Polygon financé via OKX/Binance + ~1 POL pour la première approbation de contrat
Ne lancez jamais un bot de trading en direct sur un ordinateur portable domestique qui se met en veille ou qui perd le Wi-Fi ! Nous recommandons RAKsmart Cloud VPS : (1) Choisissez Tokyo, Singapour ou Silicon Valley pour une latence ultra-faible en millisecondes vers OKX/Binance et les RPC Polygon ; (2) Sélectionnez Ubuntu 22.04 LTS (2 vCPU / 4GB RAM) pour Docker Compose ; (3) Associez votre adresse IPv4 statique dédiée à la liste blanche de l'API de votre exchange.
Vous venez d'acheter un VPS ? Comment vous connecter via SSH et exécuter des commandes sur Windows / Mac (Guide de 3 minutes)
Beaucoup d'utilisateurs débutants se perdent juste après l'achat d'un serveur cloud : « Où est-ce que je tape ces commandes du terminal ? » Suivez ces 5 étapes simples :
• Adresse IPv4 du serveur (ex.
198.51.100.88Copier)• Port SSH : Généralement
22Copier, ou un port de sécurité personnalisé comme 22022Copier / 62134Copier affiché dans votre panneau• Nom d'utilisateur : Toujours
rootCopier sur Ubuntu• Mot de passe root : Votre mot de passe initial du serveur
powershellCopier et appuyez sur Entrée.• Sur Mac : Appuyez sur Command ⌘ + Space, tapez
TerminalCopier et appuyez sur Entrée.ssh -p PORT root@SERVER_IPCopier (notez que le -pCopier est en minuscules ; omettre un port personnalisé provoque une erreur Connection refusedCopier) :• Port standard 22 :
ssh -p 22 root@198.51.100.88Copier• Port SSH personnalisé (par ex.
62134Copier) : ssh -p 62134 root@198.51.100.88CopierAre you sure you want to continue connecting (yes/no)?Copier apparaît, tapez le mot complet yesCopier et appuyez sur Entrée.• Prompt 2 ([!] Pourquoi le curseur ne bouge-t-il pas quand je tape mon mot de passe ?!) : Lorsqu'on vous demande
password :Copier, Linux masque tous les caractères (même les astérisques * n'apparaissent pas) pour des raisons de sécurité ! Collez simplement votre mot de passe invisiblement en faisant un clic droit dans PowerShell (ou en appuyant sur Cmd + VCopier sur Mac), puis appuyez sur Entrée !root@ubuntu:~#Copier, vous êtes à l'intérieur de votre serveur cloud ! Collez ces commandes de configuration une seule fois pour installer Docker, Git et Python :docker compose ...Copier : Il vous suffit de faire un clic droit pour coller dans votre fenêtre SSH et d'appuyer sur Entrée.• Pour les scripts Python (
.pyCopier) : Tapez nano bot.pyCopier et appuyez sur Entrée → Faites un clic droit pour coller le code → Appuyez sur Ctrl + O puis sur Entrée pour sauvegarder → Appuyez sur Ctrl + X pour quitter → Exécutez nohup python3 bot.py > bot.log 2>&1 &Copier pour que votre bot continue de fonctionner 24h/24, 7j/7, même après avoir fermé votre ordinateur portable !# 1. Update Ubuntu packages and install Git, Curl, and Python3
apt update -y && apt install -y curl git python3-pip python3-venv
# 2. One-line official Docker & Docker Compose installation
curl -fsSL https://get.docker.com | sh && systemctl enable --now docker
# 3. Verify Docker Compose is ready
docker compose version
import os
from py_clob_client.client import ClobClient
from py_clob_client.clob_types import OrderArgs, OrderType
from py_clob_client.order_builder.constants import BUY
# 1. 初始化 Polygon 主网 (chain_id=137) CLOB 客户端
HOST = "https://clob.polymarket.com"
CHAIN_ID = 137
PRIVATE_KEY = os.environ["POLY_PRIVATE_KEY"] # 仅存放于本地 .env,严禁硬编码上传 GitHub
FUNDER_ADDR = os.environ["POLY_PROXY_WALLET"] # Polymarket 代理合约钱包地址
client = ClobClient(HOST, key=PRIVATE_KEY, chain_id=CHAIN_ID, signature_type=1, funder=FUNDER_ADDR)
client.set_api_creds(client.create_or_derive_api_creds())
# 2. 半凯利公式 (Half-Kelly) 动态计算正期望值 (+EV) 下单份额
def compute_half_kelly_shares(bankroll_usdc: float, mkt_price: float, true_prob: float, max_cap: float = 0.15) -> float:
if true_prob <= mkt_price + 0.03: # 要求至少 +3% Alpha 安全边际才出手
return 0.0
full_kelly = (true_prob - mkt_price) / (1.0 - mkt_price)
alloc_pct = min(max_cap, 0.5 * full_kelly)
stake_usdc = bankroll_usdc * alloc_pct
return round(stake_usdc / mkt_price, 2)
# 3. 读取订单簿最优买一价并挂出 0% 手续费 Maker 限价单
TOKEN_ID = "21742633143463906290569050155826241533067272736897614950488156847949938836455"
book = client.get_order_book(TOKEN_ID)
best_bid = float(book.bids[0].price) if book.bids else 0.35
true_p = 0.52 # 来自 JEV / LLM 校准后的真实发生概率
shares = compute_half_kelly_shares(bankroll_usdc=1000.0, mkt_price=best_bid, true_prob=true_p)
if shares >= 5.0:
order_args = OrderArgs(price=best_bid, size=shares, side=BUY, token_id=TOKEN_ID)
signed_order = client.create_order(order_args)
resp = client.post_order(signed_order, OrderType.GTC)
print(f"[CLOB Maker] 挂单成功: price={best_bid:.2f} size={shares} resp={resp}")
Explication ligne par ligne du code et des commandes en langage simple
| Code / Ligne de commande | Explication en langage simple (À quoi ça sert ?) |
|---|---|
from py_clob_client.client import ClobClient
|
Importe le SDK Python officiel de Polymarket (pip install py-clob-clientCopier). |
CHAIN_ID = 137
|
137 est l'identifiant de chaîne de la chaîne principale de Polygon où tous les contrats USDC de Polymarket se règlent. |
PRIVATE_KEY = os.environ["POLY_PRIVATE_KEY"]
|
Lit la clé privée de votre sous-portefeuille de manière sûre depuis un fichier local .envCopier. |
client.create_or_derive_api_creds()
|
Dérive les identifiants de l'API CLOB L2 sans frais de gaz via une signature EIP-712. |
if true_prob <= mkt_price + 0.03: return 0.0
|
Filtre de sécurité : ne négocier que si la probabilité calibrée dépasse le prix du marché d'au moins +3 %. |
alloc_pct = min(max_cap, 0.5 * full_kelly)
|
Applique le dimensionnement Half-Kelly avec une limite maximale stricte de 15 % par ordre. |
client.post_order(signed_order, OrderType.GTC)
|
Soumet un ordre limite passif en bonne condition jusqu'à annulation (Good-Til-Cancelled) avec 0 % de frais. |
[!] Les 3 pièges courants pour les débutants et guide de dépannage
✕ Piège 1 : Confondre Market Slug avec TOKEN_IDCopier
Interrogez https://gamma-api.polymarket.com/markets?slug=<slug>Copier et copiez clobTokenIds[0]Copier pour OUI ou clobTokenIds[1]Copier pour NON.
✕ Piège 2 : Allowance / Balance not enoughCopier (Autorisation / Solde insuffisant) lors de la première commande
Placez puis annulez d'abord une seule ordre limite de 1 $ sur l'interface web de Polymarket pour que votre portefeuille proxy autorise la dépense de USDC.
✕ Piège 3 : Laisser les ordres limites obsolètes sans surveillance pendant les actualités importantes
Annulez et rafraîchissez les offres Maker en attente toutes les 60 à 90 secondes.
Étape 1 : Créer un sous-sacchet dédié et un USDC natif sur Polygon
Ne lancez jamais de scripts automatisés avec la phrase de récupération principale de votre coffre-fort à froid. Créez un sous-sacchet isolé, financez-le avec de l'USDC natif sur Polygon depuis OKX ou Binance, et conservez environ 2 $ en POL pour les approbations initiales.
Étape 2 : Dériver localement les identifiants d'API CLOB L2 dans .envCopier
Exécutez client.create_or_derive_api_creds()Copier une seule fois pour générer votre clé/secret/passphrase d'API L2. Verrouillez le fichier .envCopier avec chmod 600Copier et ajoutez-le à .gitignoreCopier.
Étape 3 : Résoudre les clobTokenIdsCopier via l'API REST Gamma
Interrogez https://gamma-api.polymarket.com/markets?slug=<market-slug>Copier pour récupérer clobTokenIds[0]Copier (jeton OUI) et clobTokenIds[1]Copier (jeton NON).
Étape 4 : Soumettre des ordres limites GTC (bon pour la durée de vie) avec une protection contre les cotes obsolètes
L'envoi d'ordres limites passifs bénéficie de 0 % de frais de maker et d'un glissement (slippage) nul sur le spread. Implétez toujours un battement de 90 secondes qui annule les ordres en attente lors d'annonces macroéconomiques importantes.
Headline Quant Guides Directory (With Reading Level, Time & Code Stack)
Start from L1 Beginner Essentials and progress to L4 Institutional Tick Backtesting. Every guide includes reading difficulty, estimated reading time, and production-ready code:
Beginner $1,000 Quant Starter Combo Deep-Dive: How Much Can You Earn Monthly Running Polymarket Penny Clipper & LP Bots?
Complete quantitative breakdown for first-time algorithmic traders starting with $1,000 USDC: ranking all 4 Polymarket open-source bot strategies by risk-adjusted edge, modeling 3 realistic monthly profit tiers ($60–$180/mo or 6%–18% monthly ROI) using 5×$200 position splitting, and enforcing the 3 iron survival rules.
Pionex Cloud AI Bots vs. Self-Hosted Polymarket Bots (CloddsBot / Grok Desk): 6 Key Differences & Dual-Engine Allocation Guide
Both are called 'quant trading bots,' yet Pionex's 16 built-in cloud bots and self-hosted open-source Polymarket bots (`CloddsBot`, `polymarket_lp_tool`, `Grok 4-Step Desk`) operate on completely different market mechanics. Pionex harvests crypto volatility and perpetual funding rates with zero code and massive liquidity capacity, while self-hosted Polymarket bots snipe $1.00 deterministic event settlement discounts and Daily LP Rewards with zero correlation to Bitcoin price swings.
Pionex AI Quantitative Trading Complete Guide: 16 Free Built-In Grid Bots, Funding-Rate Arbitrage & Polymarket Delta Hedging
Don't want to maintain a Linux VPS? Master Pionex's 16 free built-in AI trading bots (PionexGPT strategy generator, AI Infinity Grid, Spot-Futures Funding Rate Arbitrage, and 0.05% maker/taker fees) and learn how to pair Pionex BTC/ETH grids with Polymarket event tail-hedges.
CloddsBot & Polymarket LP Bot Complete Guide: Deploy 119-Skill AI Arbitrage, Penny Clipper & Daily Liquidity Rewards Bots
Why pay $5,000+ for black-box bots when the best Polymarket trading engines are MIT open-source on GitHub? Full deployment guide to `alsk1992/CloddsBot` (3.1k⭐, 119+ skills including cross-market arbitrage, Penny Clipper expiry decay, and smart-money copy trading) and `lihanyu81/polymarket_lp_tool` (passive LP market-making for daily USDC rewards).
Grok × Polymarket 4-Step Multi-Agent Trading Desk: SCAN · VERIFY · EXECUTE · EXIT Pipeline That Filters Out 90% of Bad Trades
The best agent on a quantitative trading desk has never placed a trade — its entire job is to say NO. Learn how to replace fragile single-prompt FOMO bots with an institutional 4-Agent Desk (SCAN -> VERIFY -> EXECUTE -> EXIT) for Polymarket CLOB & crypto markets: run free deterministic code filters first, invoke Grok `x_search` only on survivors, size off live cash + pool depth, and enforce 5 pre-written exit rules (`exits.py`) with full `tasks.csv` skip auditing.
Guide Quant Polymarket CLOB : Déployer un bot de copié-trading de baleines et maker sans frais de 0 % avec py-clob-client
Parcours d'ingénierie complet : dériver les identifiants Polygon L2 CLOB, interroger les ID de jetons de conditions Gamma, s'abonner aux exécutations des baleines et passer des ordres limites EIP-712 sans frais de gaz et sans frais de 0 %.
Sécurité VPS Quant, Blanchiment d'IP des API et Guide d'Ingénierie des Dispositifs d'Arrêt (Kill-Switch) de Drawdown
Checklist de sécurité en production pour les traders quantitatifs : sélection de VPS à faible latence, blanchiment d'IP des API de bourse, clés sans retrait autorisé et dispositifs d'arrêt automatiques en cas de perte journalière de 5 %.
Calibration des probabilités LLM IA + Dimensionnement Half-Kelly : intégration étape par étape de l’API DeepSeek / OpenAI / Ollama pour des ordres +EV
Guide complet étape par étape pour connecter DeepSeek, OpenAI GPT-4o ou des LLM locaux Ollama via Python, afin d’analyser les actualités de dernière minute et de les convertir en rapports de vraisemblance bayésiens structurés et en tailles de position Half-Kelly.
Tutoriel Docker Freqtrade + FreqAI : Connecter OKX / Binance, télécharger des données historiques et auditer le biais de prévision
Guide étape par étape pour déployer Freqtrade via Docker Compose, télécharger des données OHLCV multi-annuelles de OKX et Binance, exécuter des backtests réalistes ajustés aux frais et exécuter `lookahead-analysis`.
Guide au Market Making et au Delta-Hedging avec Hummingbot : Arbitrager les cotes de Polymarket contre les Futures Perps d'OKX / Binance
Comment les bureaux institutionnels combinent les contrôleurs de market-making Hummingbot V2 sur OKX/Binance avec les contrats d'événement de Polymarket pour construire des hedges de volatilité macro neutres en delta.
Guide de backtest des carnets d'ordres L2 avec NautilusTrader : Éliminer les illusions de slippage et le biais de position dans la file d'attente
Comment exécuter des backtests de ticks de carnet d'ordres L2 haute fidélité avec NautilusTrader, en intégrant des exécutations réalistes basées sur la position dans la file, la modélisation de la latence et la validation Walk-Forward.
Poly Day (p.day) — Polymarket en France : Marché Prédictif, Cotes (Odds), Ballon d'Or, Avis et Statut ANJ
Guide complet sur Polymarket en France, le marché prédictif Web3, Ballon d'Or, Ligue des Champions et accès Polygon
De nombreux utilisateurs francophones recherchent « Polymarket France », « Polymarket interdit en france » ou « marché prédictif » pour comprendre comment consulter et négocier les probabilités mondiales en temps réel. Qu'il s'agisse de la politique française, des taux de la BCE et de la Fed, du Ballon d'Or (Polymarket Ballon d'Or) ou du cours du Bitcoin, le carnet d'ordres CLOB sur Polygon affiche les cotes les plus précises du marché.
Sur Poly Day France (p.day/fr/), vous pouvez suivre librement toutes les cotes Polymarket (Polymarket odds), analyser les portefeuilles de baleines et découvrir comment approvisionner un portefeuille non-custodial en USDC (Polygon) par virement SEPA gratuit depuis la France, la Belgique, la Suisse ou le Canada.