Polymarket
Interrogez les marchés de prédiction Polymarket et tradez depuis le terminal. Parcourez les cotes, analysez les événements, comparez les marchés, suivez votre portefeuille, diffusez des données en direct, transférez des fonds et exécutez des transactions - le tout en langage naturel.
Polymarket expose 4 APIs distinctes ainsi que la couche de commodité Gamma. Cette compétence les couvre toutes.
Configuration
Les commandes en lecture seule fonctionnent immédiatement (aucune installation nécessaire). La navigation, la recherche, les tendances, les catégories, les analyses de marché et le mode comparaison utilisent tous l'API Gamma publique.
Pour les transactions, les carnets d'ordres, l'historique des prix et les fonctionnalités avancées, installez le CLI Polymarket (binaire Rust, v0.1.5+) :
brew install polymarket/tap/polymarket-cli
Pour trader, configurez un portefeuille :
polymarket wallet create
polymarket approve set
Ou configurez manuellement ~/.config/polymarket/config.json avec votre clé privée. Consultez la documentation CLI pour plus de détails.
Le CLI propose également un REPL interactif :
polymarket shell
Utilisez --output json sur n'importe quelle commande CLI pour une sortie lisible par machine, adaptée aux scripts et aux pipes.
Commandes
Parcourir les Marchés (pas besoin de CLI)
# Marchés tendances/actifs (triés par volume sur 24h)
python3 {baseDir}/scripts/polymarket.py trending
# Tendances avec plus de résultats
python3 {baseDir}/scripts/polymarket.py trending --limit 20
# Recherche de marchés par mot-clé
python3 {baseDir}/scripts/polymarket.py search "trump"
# Obtenir un événement spécifique par slug
python3 {baseDir}/scripts/polymarket.py event "fed-decision-in-october"
# Obtenir les marchés par catégorie
python3 {baseDir}/scripts/polymarket.py category politics
python3 {baseDir}/scripts/polymarket.py category crypto
python3 {baseDir}/scripts/polymarket.py category sports
python3 {baseDir}/scripts/polymarket.py category tech
python3 {baseDir}/scripts/polymarket.py category entertainment
python3 {baseDir}/scripts/polymarket.py category science
python3 {baseDir}/scripts/polymarket.py category business
Tableau de Bord des Marchés Tendances (pas besoin de CLI)
Affichez un tableau de bord catégorisé des marchés les plus chauds de Polymarket. Combinez les tendances avec des filtres de catégorie pour obtenir une vue d'ensemble complète.
# Tableau de bord des tendances complet - exécutez ces commandes en séquence pour construire une vue :
python3 {baseDir}/scripts/polymarket.py trending --limit 10
python3 {baseDir}/scripts/polymarket.py category politics --limit 5
python3 {baseDir}/scripts/polymarket.py category crypto --limit 5
python3 {baseDir}/scripts/polymarket.py category sports --limit 5
python3 {baseDir}/scripts/polymarket.py category tech --limit 5
Lorsque l'utilisateur demande un "tableau de bord" ou un "aperçu", exécutez toutes les requêtes de catégorie et présentez les résultats regroupés par section avec des titres clairs. Incluez le volume et les cotes actuelles pour chaque marché.
Mode Analyse de Marché (pas besoin de CLI)
L'analyse de marché combine les cotes Polymarket avec une analyse contextuelle. Lorsque l'utilisateur demande de "rechercher" un marché ou souhaite une analyse plus approfondie au-delà des simples cotes :
- Récupérez les données du marché à l'aide des commandes search ou event
- Analysez les cotes - qu'implique le marché ? Y a-t-il un avantage ?
- Fournissez un contexte - utilisez vos connaissances pour expliquer ce qui motive les cotes
- Montrez l'évolution historique - si le CLI est disponible, récupérez l'historique des prix
- Comparez au consensus - comment les cotes Polymarket se comparent-elles aux sondages, à l'opinion des experts ou à d'autres marchés de prédiction ?
# Étape 1 : Trouver le marché
python3 {baseDir}/scripts/polymarket.py search "fed rate cut"
# Étape 2 : Obtenir les données détaillées de l'événement
python3 {baseDir}/scripts/polymarket.py event "fed-rate-decision-march-2026"
# Étape 3 : Si le CLI est disponible, obtenir l'historique des prix pour montrer la tendance
python3 {baseDir}/scripts/polymarket.py price-history TOKEN_ID --interval 1d
# Étape 4 : Vérifier la profondeur du carnet d'ordres pour évaluer la liquidité
python3 {baseDir}/scripts/polymarket.py book TOKEN_ID
Après avoir rassemblé les données, synthétisez l'analyse dans un rapport structuré :
- Cotes Actuelles : Pourcentages Oui/Non et ce qu'ils impliquent
- Volume et Liquidité : Combien d'argent y a-t-il sur ce marché, est-il suffisamment liquide pour trader ?
- Tendance : Les cotes montent-elles ou descendent-elles ? Y a-t-il des pics récents ?
- Contexte : Quels événements ou points de données du monde réel motivent les cotes ?
- Dates Clés : Quand le marché se résout-il ? Y a-t-il des catalyseurs à venir ?
- Facteurs de Risque : Qu'est-ce qui pourrait provoquer un mouvement soudain ?
Mode Comparaison de Marchés (pas besoin de CLI)
Comparez les marchés connexes côte à côte. Utile pour trouver des arbitrages, comprendre les probabilités conditionnelles, ou simplement voir comment différents résultats sont liés.
# Comparez deux marchés connexes ou plus en recherchant chacun d'eux
python3 {baseDir}/scripts/polymarket.py search "trump 2028"
python3 {baseDir}/scripts/polymarket.py search "desantis 2028"
python3 {baseDir}/scripts/polymarket.py search "newsom 2028"
Lorsque l'utilisateur demande de "comparer des marchés" ou "cotes côte à côte" :
- Recherchez chaque marché mentionné par l'utilisateur
- Présentez les cotes dans un tableau de comparaison
- Notez les différences de volume (volume plus élevé = cotes plus fiables)
- Signalez toute incohérence apparente (par exemple, des probabilités qui devraient totaliser ~100% mais ce n'est pas le cas)
- Mettez en évidence l'écart entre les résultats connexes
Formatez la comparaison sous forme de tableau :
Comparaison des Marchés : Élection Présidentielle 2028
| Candidat | Oui | Volume | Liquidité |
|-------------|---------|---------|-----------|
| Trump | 32.5% | $4.2M | Haute |
| DeSantis | 18.1% | $1.8M | Moyenne |
| Newsom | 12.4% | $890K | Moyenne |
| Harris | 8.7% | $2.1M | Moyenne |
Tableau de Bord du Portefeuille (CLI + portefeuille requis)
Consultez votre portefeuille complet avec les positions, les P&L et les ordres ouverts en une seule vue.
# Voir toutes les positions ouvertes
python3 {baseDir}/scripts/polymarket.py positions
# Voir les positions pour un portefeuille spécifique
python3 {baseDir}/scripts/polymarket.py positions --address 0xYOUR_WALLET
# Vérifier le solde USDC
python3 {baseDir}/scripts/polymarket.py wallet-balance
# Vérifier le solde pour un jeton spécifique
python3 {baseDir}/scripts/polymarket.py wallet-balance --token TOKEN_ID
# Lister tous les ordres ouverts
python3 {baseDir}/scripts/polymarket.py orders
Lorsque l'utilisateur demande un "tableau de bord du portefeuille" ou "comment je m'en sors", exécutez les trois commandes (positions, wallet-balance, orders) et présentez une vue unifiée :
- Positions : Chaque position avec le prix actuel du marché, votre prix d'entrée (si disponible) et le P&L non réalisé
- Solde USDC : Liquidités disponibles pour de nouvelles transactions
- Ordres Ouverts : Ordres limités en attente avec prix et taille
- Valeur Totale du Portefeuille : Somme des positions + solde USDC
Carnet d'Ordres et Prix (CLI requis, pas de portefeuille)
# Carnet d'ordres pour un jeton
python3 {baseDir}/scripts/polymarket.py book TOKEN_ID
# Historique des prix (intervalles : 1m, 1h, 6h, 1d, 1w, max)
python3 {baseDir}/scripts/polymarket.py price-history TOKEN_ID --interval 1d
# Historique des prix avec un nombre spécifique de points de données
python3 {baseDir}/scripts/polymarket.py price-history TOKEN_ID --interval 1h --fidelity 48
Portefeuille (CLI requis)
polymarket wallet create
polymarket wallet show
polymarket wallet balance
polymarket wallet balance --token TOKEN_ID
Trading (CLI + portefeuille requis)
Toutes les transactions nécessitent --confirm pour être exécutées. Sans cela, la commande est seulement prévisualisée. C'est une fonction de sécurité - vous voyez toujours ce qui va se passer avant que cela n'arrive.
Transparence des Coûts et des Frais
Avant d'exécuter une transaction, la compétence affiche :
- Type d'ordre : Limité ou Au marché
- Sens : Achat ou Vente
- Prix : Votre prix limite (ou "marché" pour les ordres au marché)
- Taille : Nombre d'actions
- Coût estimé : Prix x Taille pour les ordres limités, ou montant en dollars pour les ordres au marché
- Frais Polymarket : Polymarket ne facture aucun frais de trading sur le CLOB (Central Limit Order Book)
- Frais de gaz : Les opérations on-chain (approbations, divisements, rachats) nécessitent du MATIC pour le gaz sur Polygon. Gaz typique : $0.01-0.05
# Prévisualiser un ordre limité (pas de --confirm = prévisualisation uniquement)
python3 {baseDir}/scripts/polymarket.py trade buy --token TOKEN_ID --price 0.50 --size 10
# Exécuter un ordre limité
python3 {baseDir}/scripts/polymarket.py --confirm trade buy --token TOKEN_ID --price 0.50 --size 10
# Ordre de vente limité
python3 {baseDir}/scripts/polymarket.py --confirm trade sell --token TOKEN_ID --price 0.70 --size 10
# Ordre au marché : acheter 5$ au prix actuel
python3 {baseDir}/scripts/polymarket.py --confirm trade buy --token TOKEN_ID --market-order --amount 5
# Ordre limité post-only (reste dans le carnet uniquement, ne prend jamais la liquidité - Janvier 2026+)
python3 {baseDir}/scripts/polymarket.py --confirm trade buy --token TOKEN_ID --price 0.45 --size 20 --post-only
Ordres et Positions (CLI + portefeuille requis)
# Lister les ordres ouverts
python3 {baseDir}/scripts/polymarket.py orders
# Annuler un ordre spécifique
python3 {baseDir}/scripts/polymarket.py --confirm orders --cancel ORDER_ID
# Annuler tous les ordres
python3 {baseDir}/scripts/polymarket.py --confirm orders --cancel all
# Voir les positions
python3 {baseDir}/scripts/polymarket.py positions
python3 {baseDir}/scripts/polymarket.py positions --address 0xYOUR_WALLET
Référence API
Polymarket expose 4 APIs distinctes plus la couche de commodité Gamma. Chacune sert un objectif différent.
1. API Gamma (gamma-api.polymarket.com) - Publique, sans authentification
L'API de commodité de haut niveau pour naviguer et rechercher des marchés. Utilisée par toutes les commandes en lecture seule.
- URL de base :
https://gamma-api.polymarket.com GET /events- Lister les événements (params :order,ascending,closed,limit,tag_slug)GET /search- Rechercher des marchés (params :query,limit)GET /events/slug/{slug}- Événement par slugGET /comments- Lister et filtrer les commentaires sur les marchésGET /profiles/{address}- Profils utilisateur publicsGET /series- Collections d'événements groupés (par exemple, série "Élection 2028")GET /sports- Métadonnées sportives incluant équipes, matchs et critères de résolution- GraphQL :
POST /query- Point de terminaison GraphQL complet avec support d'abonnement
2. API CLOB (clob.polymarket.com) - Trading
L'API du carnet d'ordres centralisé pour toutes les opérations de trading. Encapsulée par le CLI Polymarket.
- URL de base :
https://clob.polymarket.com GET /prices-history- Prix historiques (intervalles :1m,1h,6h,1d,1w,max)GET /spread- Écart acheteur-vendeur pour un jetonGET /fee-rate- Détails de la structure des fraisGET /rewards- Gains quotidiens maker/takerPOST /order- Passer un ordrePOST /orders- Ordres par lots (jusqu'à 15 par requête)DELETE /order/{id}- Annuler un ordre- Scoring des ordres - Vérifier l'éligibilité à la remise maker avant de passer des ordres
- Ordres Post-Only (Janvier 2026) - Ordres qui restent dans le carnet uniquement, ne croisent jamais l'écart
- API Heartbeat (Janvier 2026) :
POST /heartbeat- Doit être envoyé dans les 10 secondes, sinon tous les ordres ouverts sont automatiquement annulés- Utilisé par les teneurs de marché pour maintenir la présence des ordres
- Si le heartbeat expire, tous les ordres en attente pour cette clé API sont annulés
3. API Data (data-api.polymarket.com) - Portefeuille et Analyses
L'API dédiée au suivi de portefeuille, à l'historique des transactions et aux analyses de marché. Aucune authentification requise pour les points de terminaison publics.
- URL de base :
https://data-api.polymarket.com GET /positions?user={address}- Positions ouvertes actuelles- Trier par :
TOKENS,CURRENT,INITIAL,CASHPNL,PERCENTPNL
- Trier par :
GET /closed-positions?user={address}- Positions fermées historiquesGET /activity?user={address}- Flux d'activité- Types :
TRADE,SPLIT,MERGE,REDEEM,REWARD
- Types :
GET /value?user={address}- Valorisation du portefeuille en USDGET /trades- Historique des transactions- Filtrer par :
user,market,side - Max 500 résultats par page
- Filtrer par :
GET /holders?market={conditionId}- Principaux détenteurs de jetons pour un marchéGET /oi- Intérêt ouvert sur l'ensemble des marchésGET /volume- Volume de trading sur l'ensemble des marchésGET /leaderboard- Classements des traders (période configurable)
Utilisez l'API Data pour les tableaux de bord de portefeuille et les analyses. Elle fournit des données de position plus riches que l'API CLOB, notamment les calculs de P&L et l'historique des activités.
4. WebSocket RTDS (wss://ws-live-data.polymarket.com) - Diffusion en Temps Réel
Diffusion de données en temps réel via WebSocket. Abonnez-vous à des sujets pour des mises à jour en direct sans avoir à interroger constamment.
- URL :
wss://ws-live-data.polymarket.com - Protocole : Messages JSON sur WebSocket
- Sujets :
comments- Activité de commentaires en temps réel- Événements :
comment_created,comment_removed,reaction_created,reaction_removed
- Événements :
crypto_prices- Prix des crypto-monnaies en temps réel- Actifs : BTC, ETH, SOL, XRP
- Sources : Binance + oracles Chainlink
- Gestion dynamique des abonnements - Abonnez-vous et désabonnez-vous des sujets à la volée au sein d'une seule connexion
- Utile pour créer des tableaux de bord en direct, surveiller le sentiment des commentaires, ou suivre les prix des crypto-monnaies qui alimentent les marchés crypto de 5 minutes
5. API Bridge (bridge.polymarket.com) - Dépôts et Retraits Inter-Chaînes
Transférez des fonds vers et depuis Polymarket sur plusieurs chaînes.
- URL de base :
https://bridge.polymarket.com POST /deposit- Générer des adresses de dépôt- Chaînes supportées : EVM (Ethereum, Polygon, Arbitrum, etc.), Solana, Bitcoin
- Renvoie une adresse de dépôt unique pour la chaîne sélectionnée
POST /withdraw(Janvier 2026) - Transférer USDC.e vers n'importe quelle chaîne supportéeGET /supported-assets- Lister tous les actifs et chaînes supportésGET /quote- Obtenir des devis de transfert inter-chaînes (frais, temps estimé)
Utilisez l'API Bridge lorsqu'un utilisateur doit déplacer des fonds vers ou depuis Polymarket sans quitter le terminal.
Nouveaux Types de Marchés
- Marchés crypto de 5 minutes (Février 2026) - Marchés de très courte durée sur les mouvements de prix BTC/ETH/SOL. Alimentés par les données RTDS crypto_prices.
- Marchés sportifs - Métadonnées sportives dédiées via le point de terminaison Gamma
/sportsavec informations sur les équipes, calendriers des matchs et critères de résolution.
Récupération d'Erreurs
Erreurs API (Gamma API)
Si l'API Gamma renvoie une erreur ou est inaccessible :
- HTTP 429 (Limite de débit dépassée) - Attendez 2-3 secondes et réessayez. Utilisez le mode lent si disponible.
- HTTP 5xx - L'API peut être temporairement indisponible. Attendez 10 secondes et réessayez une fois.
- Échec de connexion - Vérifiez la connectivité Internet. Polymarket nécessite une connexion réseau active.
Erreurs CLI
- "Command not found" - Le CLI Polymarket n'est pas installé. Installez-le avec
brew install polymarket/tap/polymarket-cli - "Wallet not configured" - L'utilisateur n'a pas configuré de portefeuille. Exécutez
polymarket wallet created'abord - "Insufficient balance" - L'utilisateur n'a pas assez de fonds. Vérifiez le solde avec
polymarket wallet balance
Erreurs de Trading
- Échec de soumission d'ordre - L'ordre a été rejeté. Causes courantes : prix hors limites (l'ordre dépasse l'écart maximum), portefeuille non approuvé, solde insuffisant
- Transaction bloquée - Le réseau Polygon peut être congestionné. Réessayez avec des frais de gaz plus élevés ou attendez que la congestion diminue
- Jeton non trouvé - Le TOKEN_ID est invalide. Utilisez les commandes de recherche ou d'événement pour trouver le bon jeton