En bref
Polymarket CLI est un outil en ligne de commande basé sur Rust qui vous permet de parcourir les marchés de prédiction, de passer des ordres, de gérer des positions et d'interagir avec des contrats on-chain directement depuis votre terminal. Installez-le via Homebrew ou un script shell, parcourez les marchés sans portefeuille, et tradez en utilisant la sortie JSON pour l'automatisation. Nécessite une clé privée pour les opérations de trading. Prend en charge les formats de sortie tableau et JSON pour une utilisation lisible par l'homme et programmatique.
Introduction
Les marchés de prédiction sont devenus des outils puissants pour prévoir des événements du monde réel, des résultats électoraux aux mouvements des prix des cryptomonnaies. Polymarket, construit sur Polygon, offre l'un des marchés de prédiction les plus liquides avec des millions de dollars de volume de trading. Bien que l'interface web soit intuitive, les développeurs souhaitent souvent un accès programmatique pour l'automatisation, le scripting et la création de bots de trading personnalisés.
C'est là qu'intervient Polymarket CLI. Cet outil en ligne de commande basé sur Rust offre un accès complet à l'écosystème Polymarket depuis votre terminal. Que vous souhaitiez parcourir les marchés, analyser les carnets d'ordres ou exécuter des transactions automatiquement, Polymarket CLI offre une interface robuste qui s'intègre parfaitement aux scripts shell et aux flux de travail d'automatisation.
Qu'est-ce que Polymarket ?
Polymarket est une plateforme de marché de prédiction décentralisée construite sur la blockchain Polygon. Elle permet aux utilisateurs de trader sur les résultats d'événements du monde réel en utilisant le stablecoin USDC. Les marchés sont structurés en questions oui/non, les prix représentant la probabilité d'un résultat (par exemple, 52¢ signifie une probabilité de 52%).
Les principales caractéristiques de Polymarket incluent :
- Trading décentralisé : Construit sur Polygon pour des transactions rapides et à faible coût
- Marchés en temps réel : Des milliers de marchés couvrant la politique, la crypto, le sport, et plus encore
- Modèle de carnet d'ordres : Carnet d'ordres central à cours limité (CLOB) pour la découverte des prix
- Jetons conditionnels : Jetons ERC-1155 représentant des parts de résultat
- Programme de récompenses : Les traders peuvent gagner des récompenses basées sur le volume de trading
Polymarket CLI se connecte à ces marchés via une combinaison d'API off-chain (pour la lecture des données de marché et le placement d'ordres) et de contrats on-chain (pour les opérations de jetons comme le fractionnement, la fusion et le rachat).
Installation de Polymarket CLI
Polymarket CLI prend en charge plusieurs méthodes d'installation. Choisissez celle qui convient à votre environnement.
Option 1 : Homebrew (macOS / Linux)
La méthode d'installation la plus simple utilise Homebrew :
# Ajoutez le tap Polymarket
brew tap Polymarket/polymarket-cli https://github.com/Polymarket/polymarket-cli
# Installez polymarket
brew install polymarket
Option 2 : Script Shell (Linux/macOS)
Pour une installation rapide en une ligne :
curl -sSL https://raw.githubusercontent.com/Polymarket/polymarket-cli/main/install.sh | sh
Cela télécharge le dernier binaire et l'installe dans votre PATH.
Option 3 : Compilation depuis les sources (Toutes plateformes)
Si Rust est installé, vous pouvez compiler depuis les sources :
git clone https://github.com/Polymarket/polymarket-cli
cd polymarket-cli
cargo install --path .
Vérification de l'installation
Vérifiez que l'installation a réussi :
polymarket --version
polymarket --help
Vous devriez voir les informations de version et un message d'aide avec les commandes disponibles.
Démarrage rapide : Parcourir les marchés sans portefeuille
L'une des meilleures fonctionnalités de Polymarket CLI est que vous n'avez pas besoin de portefeuille pour parcourir les marchés. Cela le rend parfait pour la recherche et le monitoring avant d'engager des fonds.
Parcourir les marchés récents
# Liste les 5 marchés les plus récents
polymarket markets list --limit 5
Sortie attendue :
Rechercher des marchés spécifiques
# Rechercher des marchés liés au Bitcoin
polymarket markets search "bitcoin" --limit 5
Filtrer par statut et volume
# Lister les marchés clôturés
polymarket markets list --closed true --limit 20
Parcourir les événements
Les événements regroupent les marchés liés. Par exemple, l'événement "Élection 2024" contient plusieurs marchés sur différents aspects de l'élection.
# Lister les événements récents
polymarket events list --limit 10
# Filtrer les événements par tag
polymarket events list --tag politics --active true
# Obtenir un événement spécifique
polymarket events get 500
Configuration du portefeuille
Si la navigation ne nécessite pas de portefeuille, le trading en requiert un. Voici comment configurer votre portefeuille.
Création d'un nouveau portefeuille
# Créer un nouveau portefeuille (génère une clé aléatoire, l'enregistre dans la config)
polymarket wallet create
Cela génère une nouvelle clé privée et la stocke dans votre fichier de configuration à ~/.config/polymarket/config.json.
Importation d'un portefeuille existant
Si vous avez déjà un portefeuille avec des fonds :
polymarket wallet import 0xYOUR_PRIVATE_KEY_HERE
Emplacement du fichier de configuration
Le fichier de configuration est stocké à ~/.config/polymarket/config.json et ressemble à :
{
"private_key": "0xabc123...",
"chain_id": 137,
"signature_type": "proxy"
}
Méthodes de configuration du portefeuille
Vous pouvez fournir votre clé privée de trois manières (vérifiées dans cet ordre) :
- Flag CLI :
--private-key 0xabc... - Variable d'environnement :
POLYMARKET_PRIVATE_KEY=0xabc... - Fichier de configuration :
~/.config/polymarket/config.json
Types de signature
Polymarket prend en charge trois types de signature :
| Type | Description |
|---|---|
proxy (par défaut) | Utilise le système de portefeuille proxy de Polymarket |
eoa | Signe directement avec votre clé |
gnosis-safe | Pour les portefeuilles multi-signatures |
Outrepasser par commande avec --signature-type eoa.
Vérification du statut du portefeuille
# Afficher toutes les informations du portefeuille
polymarket wallet show
# Afficher juste l'adresse
polymarket wallet address
Approbations de contrats
Avant de trader, vous devez approuver les contrats Polymarket :
# Vérifier les approbations actuelles (lecture seule)
polymarket approve check
# Approuver tous les contrats (envoie 6 transactions on-chain)
polymarket approve set
Note : L'approbation des contrats nécessite du MATIC pour les frais de gaz sur Polygon.
Exploration des marchés et des événements
Plongeons plus profondément dans les commandes d'exploration de marché.
Commandes de marché
# Obtenir des informations détaillées sur le marché
polymarket markets get will-bitcoin-hit-100k
# Obtenir les tags d'un marché
polymarket markets tags MARKET_ID
# Lister les marchés avec divers filtres
polymarket markets list \
--active true \
--order volume_num \
--limit 20 \
--offset 10
Commandes d'événement
# Lister les événements avec des filtres
polymarket events list --active true --limit 10
# Obtenir les tags d'un événement
polymarket events tags EVENT_ID
# Séries (événements récurrents comme les marchés hebdomadaires)
polymarket series list --limit 10
polymarket series get SERIES_ID
Commandes de tags
# Lister tous les tags
polymarket tags list
# Obtenir des informations spécifiques sur un tag
polymarket tags get politics
# Trouver des tags liés
polymarket tags related politics
Commandes CLOB (Carnet d'ordres)
Vérifiez les prix et les carnets d'ordres sans portefeuille :
# Vérifier la santé de l'API
polymarket clob ok
# Obtenir le prix d'un jeton
polymarket clob price TOKEN_ID --side buy
polymarket clob midpoint TOKEN_ID
# Obtenir le spread
polymarket clob spread TOKEN_ID
# Obtenir le carnet d'ordres
polymarket clob book TOKEN_ID
# Dernier prix échangé
polymarket clob last-trade TOKEN_ID
# Historique des prix
polymarket clob price-history TOKEN_ID --interval 1d --fidelity 30
Options d'intervalle : 1m, 1h, 6h, 1d, 1w, max
Trading sur Polymarket
Maintenant, la partie excitante — passer des transactions. Ces commandes nécessitent un portefeuille configuré.
Passage d'ordres
# Placer un ordre limite (acheter 10 parts à 0,50 $)
polymarket clob create-order \
--token TOKEN_ID \
--side buy \
--price 0.50 \
--size 10
# Placer un ordre au marché (acheter pour 5 $)
polymarket clob market-order \
--token TOKEN_ID \
--side buy \
--amount 5
# Publier plusieurs ordres à la fois
polymarket clob post-orders \
--tokens "TOKEN1,TOKEN2" \
--side buy \
--prices "0.40,0.60" \
--sizes "10,10"
Types d'ordres : GTC (Bon jusqu'à annulation - par défaut), FOK (Exécuter ou Annuler), GTD (Bon jusqu'à la date), FAK (Exécuter et Annuler)
Ajoutez --post-only pour les ordres limites qui n'ajoutent que de la liquidité.
Gestion des ordres
# Afficher vos ordres
polymarket clob orders
# Obtenir les détails d'un ordre spécifique
polymarket clob order ORDER_ID
# Annuler un seul ordre
polymarket clob cancel ORDER_ID
# Annuler plusieurs ordres
polymarket clob cancel-orders "ORDER1,ORDER2"
# Annuler tous les ordres pour un marché
polymarket clob cancel-market --market CONDITION_ID
# Annuler tous les ordres
polymarket clob cancel-all
Vérification des soldes et des transactions
# Vérifier le solde USDC
polymarket clob balance --asset-type collateral
# Vérifier le solde de jetons conditionnels
polymarket clob balance --asset-type conditional --token TOKEN_ID
# Afficher vos transactions
polymarket clob trades
# Mettre à jour le solde (rafraîchir depuis la chaîne)
polymarket clob update-balance --asset-type collateral
Récompenses et clés API
# Vérifier les récompenses
polymarket clob rewards --date 2024-06-15
polymarket clob current-rewards
# Vérifier si les ordres rapportent des récompenses
polymarket clob order-scoring ORDER_ID
# Créer une clé API pour un accès programmatique
polymarket clob create-api-key
# Lister vos clés API
polymarket clob api-keys
Opérations On-Chain
Polymarket CLI prend également en charge l'interaction directe avec les contrats on-chain.
Opérations CTF (Framework de Jetons Conditionnels)
# Fractionner 10 $ USDC en jetons OUI/NON
polymarket ctf split --condition CONDITION_ID --amount 10
# Fusionner les jetons en USDC
polymarket ctf merge --condition CONDITION_ID --amount 10
# Réclamer les jetons gagnants après résolution
polymarket ctf redeem --condition CONDITION_ID
Note : Les opérations on-chain nécessitent du MATIC pour le gaz sur Polygon.
Opérations de pont
Déposer des actifs depuis d'autres chaînes :
# Obtenir les adresses de dépôt pour EVM, Solana, Bitcoin
polymarket bridge deposit YOUR_POLYGON_ADDRESS
# Lister les chaînes et jetons pris en charge
polymarket bridge supported-assets
# Vérifier le statut du dépôt
polymarket bridge status DEPOSIT_ADDRESS
Données de portefeuille
# Afficher les positions actuelles
polymarket data positions YOUR_WALLET_ADDRESS
# Afficher les positions clôturées
polymarket data closed-positions YOUR_WALLET_ADDRESS
# Valeur totale du portefeuille
polymarket data value YOUR_WALLET_ADDRESS
# Historique des transactions
polymarket data trades YOUR_WALLET_ADDRESS --limit 50
Utilisation de la sortie JSON pour les scripts
L'une des fonctionnalités les plus puissantes de Polymarket CLI est la sortie JSON, ce qui la rend parfaite pour le scripting et l'automatisation.
Sortie JSON de base
# Obtenir les marchés en JSON
polymarket -o json markets list --limit 10
Sortie :
[
{"id": "12345", "question": "Will BTC hit $100k?", "outcomePrices": ["0.67", "0.33"], ...},
{"id": "67890", "question": "Will ETH flip BTC?", "outcomePrices": ["0.12", "0.88"], ...}
]
Utilisation avec jq
# Extraire seulement les questions
polymarket -o json markets list --limit 100 | jq '.[].question'
# Obtenir des données de prix spécifiques
polymarket -o json clob midpoint TOKEN_ID | jq '.mid'
# Filtrer les marchés par volume
polymarket -o json markets list --limit 100 | jq '.[] | select(.volume_num > 1000000)'
Gestion des erreurs dans les scripts
#!/bin/bash
# Exemple : Vérifier le solde avec gestion des erreurs
if ! result=$(polymarket -o json clob balance --asset-type collateral 2>/dev/null); then
echo "Échec de la récupération du solde"
exit 1
fi
balance=$(echo "$result" | jq -r '.balance')
echo "Votre solde : $balance USDC"
Automatisation de la surveillance des marchés
Créer un simple moniteur de marché :
#!/bin/bash
# monitor-market.sh - Surveille le prix d'un marché spécifique
TOKEN_ID=$1
INTERVAL=${2:-60} # 60 secondes par défaut
while true; do
clear
echo "Surveillance du marché : $(date)"
polymarket clob price $TOKEN_ID --side buy
polymarket clob price $TOKEN_ID --side sell
echo ""
polymarket clob book $TOKEN_ID | head -20
sleep $INTERVAL
done
Exécutez-le avec : ./monitor-market.sh TOKEN_ID 30
Tester l'API Polymarket avec Apidog
Lors de la création de systèmes de trading automatisés ou de l'intégration de Polymarket dans vos applications, des tests d'API approfondis sont essentiels. Apidog fournit une plateforme de développement d'API puissante et tout-en-un qui rend le test des API de marchés de prédiction simple et efficace.
Pourquoi utiliser Apidog pour l'intégration Polymarket ?
Que vous construisiez un bot de trading, un tableau de bord d'analyse de marché ou que vous intégriez des données Polymarket dans votre application, Apidog offre plusieurs avantages :
- Client API Visuel : Envoyez des requêtes et inspectez les réponses sans écrire de code
- Tests automatisés : Créez des suites de tests pour vérifier votre logique de trading
- Variables d'environnement : Gérez les points d'accès API et les identifiants entre dev/staging/prod
- Collaboration : Partagez les définitions d'API avec votre équipe
Mode Shell Interactif
Pour une exploration interactive, utilisez le shell intégré :
polymarket shell
Cela ouvre un REPL interactif :
polymarket> markets list --limit 3
polymarket> clob book TOKEN_ID
polymarket> exit
Le shell prend en charge l'historique des commandes, ce qui facilite l'expérimentation avec différentes commandes.
Flux de travail courants
Flux de travail 1 : Recherche et trading
# Étape 1 : Trouver des marchés intéressants
polymarket markets search "bitcoin" --limit 10
polymarket markets get bitcoin-above-100k
# Étape 2 : Vérifier le carnet d'ordres et les prix
polymarket clob book TOKEN_ID
polymarket clob price-history TOKEN_ID --interval 1d
# Étape 3 : Vérifier votre solde
polymarket clob balance --asset-type collateral
# Étape 4 : Placer une transaction
polymarket clob market-order --token TOKEN_ID --side buy --amount 10
Flux de travail 2 : Gestion de portefeuille
# Afficher toutes les positions
polymarket data positions YOUR_ADDRESS
# Vérifier la valeur totale
polymarket data value YOUR_ADDRESS
# Afficher l'historique des transactions
polymarket data trades YOUR_ADDRESS --limit 50
# Vérifier les ordres ouverts
polymarket clob orders
Flux de travail 3 : Bot de trading programmatique
#!/bin/bash
# Bot simple : acheter lorsque le prix passe sous un seuil
TOKEN_ID="YOUR_TOKEN_ID"
THRESHOLD=0.45
AMOUNT=10
# Obtenir le prix actuel
PRICE=$(polymarket -o json clob midpoint $TOKEN_ID | jq -r '.mid')
# Convertir en décimal
PRICE_DECIMAL=$(echo "scale=2; $PRICE / 100" | bc)
if (( $(echo "$PRICE_DECIMAL < $THRESHOLD" | bc -l) )); then
echo "Prix ($PRICE_DECIMAL) inférieur au seuil ($THRESHOLD) - achat"
polymarket clob market-order --token $TOKEN_ID --side buy --amount $AMOUNT
else
echo "Prix ($PRICE_DECIMAL) supérieur au seuil - maintien"
fi
Considérations de sécurité
Lors de l'utilisation de Polymarket CLI, gardez à l'esprit ces bonnes pratiques de sécurité :
Sécurité de la clé privée
- Ne jamais commettre votre clé privée au contrôle de version
- Utilisez le fichier de configuration plutôt que les variables d'environnement dans des environnements partagés
- Envisagez l'intégration d'un portefeuille matériel pour les fonds importants
- Utilisez un portefeuille séparé pour le trading CLI (pas votre portefeuille principal)
Vérification des transactions
- Toujours vérifier les détails de la transaction avant de confirmer
- Commencez par de petits montants pour tester votre configuration
- Gardez votre solde MATIC suffisant pour les frais de gaz
Gestion des clés API
# Créer des clés API dédiées pour les scripts
polymarket clob create-api-key
# Lister et gérer les clés
polymarket clob api-keys
# Supprimer les clés compromises
polymarket clob delete-api-key
Sécurité réseau
- Utilisez le CLI via HTTPS (par défaut)
- Soyez prudent lors de l'utilisation de clés privées dans des environnements cloud
- Envisagez d'utiliser un VPN lors du trading depuis des réseaux publics
Conclusion
Polymarket CLI est un outil puissant pour les développeurs qui souhaitent interagir programmatiquement avec les marchés de prédiction. Que vous soyez un trader cherchant à automatiser des stratégies, un chercheur analysant des données de marché, ou un développeur créant des bots de trading, le CLI fournit une interface robuste à l'écosystème Polymarket.
Points clés à retenir de ce guide :
- Installez via Homebrew ou un script shell pour une configuration rapide
- Parcourez les marchés sans portefeuille pour la recherche
- Configurez correctement votre portefeuille avant de trader
- Utilisez la sortie JSON pour le scripting et l'automatisation
- Priorisez toujours la sécurité lors de la manipulation des clés privées
- Commencez par de petites transactions pour tester votre configuration
- Utilisez Apidog pour tester et valider vos intégrations API Polymarket
Pour des cas d'utilisation plus avancés, envisagez de combiner Polymarket CLI avec d'autres outils comme cron pour les tâches planifiées, jq pour le traitement des données, ou des bots personnalisés construits en Python ou Node.js. Lors de la création de votre intégration de trading, utilisez Apidog pour tester en profondeur tous les points d'accès API avant la mise en ligne.
Essayez Apidog gratuitement pour rationaliser votre flux de travail de test d'API et renforcer la confiance dans vos intégrations Polymarket.
FAQ
Polymarket CLI est-il sûr à utiliser ?
Polymarket CLI est un logiciel expérimental. Utilisez-le avec prudence et ne l'utilisez jamais avec de grandes quantités de fonds. Vérifiez toujours les transactions avant de confirmer. Le projet est open source, vous pouvez donc consulter le code vous-même.
Ai-je besoin d'un portefeuille pour parcourir les marchés ?
Non. La plupart des commandes (marchés, événements, prix CLOB, carnets d'ordres) fonctionnent sans portefeuille. Vous n'avez besoin d'un portefeuille que pour passer des ordres, vérifier les soldes et les opérations on-chain.
Quelles blockchains Polymarket prend-il en charge ?
Polymarket est construit sur Polygon (ID de chaîne 137). Le CLI gère à la fois les opérations on-chain (nécessitant du MATIC pour le gaz) et le placement d'ordres off-chain.
Puis-je utiliser Polymarket CLI pour le trading automatisé ?
Oui. Le format de sortie JSON le rend idéal pour le scripting. Vous pouvez créer des bots de trading automatisés en utilisant des scripts shell, Python, ou tout langage pouvant exécuter des commandes CLI et analyser du JSON.
Comment obtenir de l'aide avec Polymarket CLI ?
Consultez le dépôt GitHub officiel pour la documentation et le suivi des problèmes.
Polymarket CLI prend-il en charge le testnet ?
La version actuelle fonctionne avec le déploiement principal de Polymarket. Pour la prise en charge du testnet, consultez le dépôt GitHub pour les dernières informations.
Quelle est la différence entre les types de signature proxy et eoa ?
proxy (par défaut) utilise le système de portefeuille proxy de Polymarket, ce qui peut réduire les coûts de gaz. eoa signe directement avec votre clé privée. Pour la plupart des utilisateurs, le type proxy par défaut est recommandé.
Comment mettre à jour Polymarket CLI vers la dernière version ?
Exécutez polymarket upgrade pour vérifier et installer les mises à jour. Pour les installations Homebrew, utilisez brew update && brew upgrade polymarket.
Puis-je utiliser Apidog pour tester les appels d'API Polymarket ?
Oui. Apidog est un excellent outil pour tester les API des marchés de prédiction. Créez un nouveau projet dans Apidog, ajoutez vos points d'accès Polymarket, et utilisez le client visuel pour envoyer des requêtes et inspecter les réponses. Les variables d'environnement d'Apidog facilitent la gestion des différentes identifiants API, et vous pouvez créer des scénarios de test automatisés pour vérifier que votre logique de trading fonctionne correctement.