Kurz gesagt
Polymarket CLI ist ein Rust-basiertes Befehlszeilentool, mit dem Sie Prognosemärkte durchsuchen, Aufträge platzieren, Positionen verwalten und direkt von Ihrem Terminal aus mit On-Chain-Verträgen interagieren können. Installation über Homebrew oder Shell-Skript, Marktübersicht ohne Wallet und Handel mithilfe von JSON-Ausgabe zur Automatisierung. Für Handelsoperationen ist ein privater Schlüssel erforderlich. Unterstützt Tabellen- und JSON-Ausgabeformate für die menschliche Lesbarkeit und die programmatische Verwendung.
Einleitung
Prognosemärkte haben sich als leistungsstarke Werkzeuge zur Vorhersage realer Ereignisse etabliert, von Wahlergebnissen bis hin zu Krypto-Preisentwicklungen. Polymarket, aufgebaut auf Polygon, bietet einen der liquidesten Prognosemärkte mit einem Handelsvolumen von Millionen. Während die Weboberfläche intuitiv ist, wünschen sich Entwickler oft programmatischen Zugriff für Automatisierung, Skripterstellung und den Bau eigener Handelsbots.
Hier kommt die Polymarket CLI ins Spiel. Dieses Rust-basierte Befehlszeilentool bietet vollständigen Zugriff auf das Polymarket-Ökosystem direkt von Ihrem Terminal aus. Egal, ob Sie Märkte durchsuchen, Orderbücher analysieren oder Trades automatisch ausführen möchten, die Polymarket CLI bietet eine robuste Schnittstelle, die sich nahtlos in Shell-Skripte und Automatisierungs-Workflows integrieren lässt.
Was ist Polymarket?
Polymarket ist eine dezentrale Prognosemarkt-Plattform, die auf der Polygon-Blockchain aufgebaut ist. Sie ermöglicht es Benutzern, auf die Ergebnisse realer Ereignisse unter Verwendung des USDC-Stablecoins zu handeln. Märkte sind als Ja/Nein-Fragen strukturiert, wobei die Preise die Wahrscheinlichkeit eines Ergebnisses darstellen (z.B. 52¢ bedeutet 52% Wahrscheinlichkeit).
Hauptmerkmale von Polymarket sind:
- Dezentralisierter Handel: Auf Polygon aufgebaut für schnelle, kostengünstige Transaktionen
- Echtzeit-Märkte: Tausende von Märkten, die Politik, Krypto, Sport und mehr abdecken
- Orderbuch-Modell: Zentrales Limit-Orderbuch (CLOB) zur Preisfindung
- Konditionale Token: ERC-1155-Token, die Ergebnisanteile repräsentieren
- Belohnungsprogramm: Trader können Belohnungen basierend auf dem Handelsvolumen verdienen
Die Polymarket CLI verbindet sich mit diesen Märkten durch eine Kombination aus Off-Chain-APIs (zum Lesen von Marktdaten und Platzieren von Aufträgen) und On-Chain-Verträgen (für Token-Operationen wie das Aufteilen, Zusammenführen und Einlösen).
Installation der Polymarket CLI
Polymarket CLI unterstützt mehrere Installationsmethoden. Wählen Sie diejenige, die zu Ihrer Umgebung passt.
Option 1: Homebrew (macOS / Linux)
Die einfachste Installationsmethode verwendet Homebrew:
# Add the Polymarket tap
brew tap Polymarket/polymarket-cli https://github.com/Polymarket/polymarket-cli
# Install polymarket
brew install polymarket
Option 2: Shell-Skript (Linux/macOS)
Für eine schnelle Ein-Zeilen-Installation:
curl -sSL https://raw.githubusercontent.com/Polymarket/polymarket-cli/main/install.sh | sh
Dies lädt die neueste Binärdatei herunter und installiert sie in Ihrem PATH.
Option 3: Aus dem Quellcode erstellen (alle Plattformen)
Wenn Sie Rust installiert haben, können Sie aus dem Quellcode erstellen:
git clone https://github.com/Polymarket/polymarket-cli
cd polymarket-cli
cargo install --path .
Installation überprüfen
Überprüfen Sie, ob die Installation erfolgreich war:
polymarket --version
polymarket --help
Sie sollten Versionsinformationen und eine Hilfemeldung mit verfügbaren Befehlen sehen.
Schnellstart: Märkte ohne Wallet durchsuchen
Eine der besten Funktionen der Polymarket CLI ist, dass Sie keine Wallet benötigen, um Märkte zu durchsuchen. Dies macht sie perfekt für Recherche und Überwachung, bevor Sie Gelder einsetzen.
Aktuelle Märkte durchsuchen
# Listet die 5 neuesten Märkte auf
polymarket markets list --limit 5
Erwartete Ausgabe:
Nach bestimmten Märkten suchen
# Sucht nach Bitcoin-bezogenen Märkten
polymarket markets search "bitcoin" --limit 5
Nach Status und Volumen filtern
# Listet geschlossene Märkte auf
polymarket markets list --closed true --limit 20
Ereignisse durchsuchen
Ereignisse gruppieren verwandte Märkte zusammen. Zum Beispiel enthält das Ereignis "Wahl 2024" mehrere Märkte zu verschiedenen Aspekten der Wahl.
# Listet aktuelle Ereignisse auf
polymarket events list --limit 10
# Filtert Ereignisse nach Tag
polymarket events list --tag politics --active true
# Ruft ein bestimmtes Ereignis ab
polymarket events get 500
Wallet-Einrichtung und Konfiguration
Während das Durchsuchen keine Wallet erfordert, ist sie für den Handel notwendig. So richten Sie Ihre Wallet ein.
Eine neue Wallet erstellen
# Erstellt eine neue Wallet (generiert einen zufälligen Schlüssel, speichert ihn in der Konfiguration)
polymarket wallet create
Dies generiert einen neuen privaten Schlüssel und speichert ihn in Ihrer Konfigurationsdatei unter ~/.config/polymarket/config.json.
Eine bestehende Wallet importieren
Wenn Sie bereits eine Wallet mit Guthaben haben:
polymarket wallet import 0xYOUR_PRIVATE_KEY_HERE
Speicherort der Konfigurationsdatei
Die Konfigurationsdatei wird unter ~/.config/polymarket/config.json gespeichert und sieht folgendermaßen aus:
{
"private_key": "0xabc123...",
"chain_id": 137,
"signature_type": "proxy"
}
Methoden zur Wallet-Konfiguration
Sie können Ihren privaten Schlüssel auf drei Arten angeben (in dieser Reihenfolge geprüft):
- CLI-Flag:
--private-key 0xabc... - Umgebungsvariable:
POLYMARKET_PRIVATE_KEY=0xabc... - Konfigurationsdatei:
~/.config/polymarket/config.json
Signaturtypen
Polymarket unterstützt drei Signaturtypen:
| Typ | Beschreibung |
|---|---|
proxy (Standard) | Verwendet das Proxy-Wallet-System von Polymarket |
eoa | Signiert direkt mit Ihrem Schlüssel |
gnosis-safe | Für Multisig-Wallets |
Pro Befehl mit --signature-type eoa überschreiben.
Wallet-Status überprüfen
# Zeigt vollständige Wallet-Informationen an
polymarket wallet show
# Gibt nur die Adresse aus
polymarket wallet address
Vertragsgenehmigungen
Vor dem Handel müssen Sie die Polymarket-Verträge genehmigen:
# Überprüft aktuelle Genehmigungen (nur lesen)
polymarket approve check
# Genehmigt alle Verträge (sendet 6 On-Chain-Transaktionen)
polymarket approve set
Hinweis: Die Genehmigung von Verträgen erfordert MATIC für Gasgebühren auf Polygon.
Märkte und Ereignisse erkunden
Tauchen wir tiefer in die Befehle zur Markterkundung ein.
Marktbefehle
# Ruft detaillierte Marktinformationen ab
polymarket markets get will-bitcoin-hit-100k
# Ruft Tags für einen Markt ab
polymarket markets tags MARKET_ID
# Listet Märkte mit verschiedenen Filtern auf
polymarket markets list \
--active true \
--order volume_num \
--limit 20 \
--offset 10
Ereignisbefehle
# Listet Ereignisse mit Filtern auf
polymarket events list --active true --limit 10
# Ruft Ereignis-Tags ab
polymarket events tags EVENT_ID
# Serien (wiederkehrende Ereignisse wie wöchentliche Märkte)
polymarket series list --limit 10
polymarket series get SERIES_ID
Tag-Befehle
# Listet alle Tags auf
polymarket tags list
# Ruft spezifische Tag-Informationen ab
polymarket tags get politics
# Findet verwandte Tags
polymarket tags related politics
CLOB (Orderbuch) Befehle
Preise und Orderbücher ohne Wallet prüfen:
# Überprüft den API-Zustand
polymarket clob ok
# Ruft den Preis für einen Token ab
polymarket clob price TOKEN_ID --side buy
polymarket clob midpoint TOKEN_ID
# Ruft den Spread ab
polymarket clob spread TOKEN_ID
# Ruft das Orderbuch ab
polymarket clob book TOKEN_ID
# Letzter Handelspreis
polymarket clob last-trade TOKEN_ID
# Preishistorie
polymarket clob price-history TOKEN_ID --interval 1d --fidelity 30
Intervalloptionen: 1m, 1h, 6h, 1d, 1w, max
Handel auf Polymarket
Nun zum spannenden Teil – dem Platzieren von Trades. Diese Befehle erfordern eine konfigurierte Wallet.
Aufträge platzieren
# Platziert einen Limit-Auftrag (kauft 10 Anteile zu $0,50)
polymarket clob create-order \
--token TOKEN_ID \
--side buy \
--price 0.50 \
--size 10
# Platziert einen Markt-Auftrag (kauft im Wert von $5)
polymarket clob market-order \
--token TOKEN_ID \
--side buy \
--amount 5
# Platziert mehrere Aufträge gleichzeitig
polymarket clob post-orders \
--tokens "TOKEN1,TOKEN2" \
--side buy \
--prices "0.40,0.60" \
--sizes "10,10"
Auftragstypen: GTC (Good Till Cancel - Standard), FOK (Fill or Kill), GTD (Good Till Date), FAK (Fill and Kill)
Fügen Sie --post-only für Limit-Orders hinzu, die nur Liquidität hinzufügen.
Aufträge verwalten
# Zeigt Ihre Aufträge an
polymarket clob orders
# Ruft spezifische Auftragsdetails ab
polymarket clob order ORDER_ID
# Storniert einen einzelnen Auftrag
polymarket clob cancel ORDER_ID
# Storniert mehrere Aufträge
polymarket clob cancel-orders "ORDER1,ORDER2"
# Storniert alle Aufträge für einen Markt
polymarket clob cancel-market --market CONDITION_ID
# Storniert alle Aufträge
polymarket clob cancel-all
Guthaben und Trades überprüfen
# Überprüft das USDC-Guthaben
polymarket clob balance --asset-type collateral
# Überprüft das konditionale Token-Guthaben
polymarket clob balance --asset-type conditional --token TOKEN_ID
# Zeigt Ihre Trades an
polymarket clob trades
# Guthaben aktualisieren (von der Kette neu laden)
polymarket clob update-balance --asset-type collateral
Belohnungen und API-Schlüssel
# Überprüft Belohnungen
polymarket clob rewards --date 2024-06-15
polymarket clob current-rewards
# Überprüft, ob Aufträge Belohnungen erzielen
polymarket clob order-scoring ORDER_ID
# Erstellt einen API-Schlüssel für programmatischen Zugriff
polymarket clob create-api-key
# Listet Ihre API-Schlüssel auf
polymarket clob api-keys
On-Chain-Operationen
Die Polymarket CLI unterstützt auch die direkte Interaktion mit On-Chain-Verträgen.
CTF (Conditional Token Framework) Operationen
# Teilt 10 USDC in JA/NEIN-Token auf
polymarket ctf split --condition CONDITION_ID --amount 10
# Fügt Token wieder zu USDC zusammen
polymarket ctf merge --condition CONDITION_ID --amount 10
# Löst gewinnende Token nach der Auflösung ein
polymarket ctf redeem --condition CONDITION_ID
Hinweis: On-Chain-Operationen erfordern MATIC für Gas auf Polygon.
Bridge-Operationen
Vermögenswerte von anderen Ketten einzahlen:
# Ruft Einzahlungsadressen für EVM, Solana, Bitcoin ab
polymarket bridge deposit YOUR_POLYGON_ADDRESS
# Listet unterstützte Ketten und Token auf
polymarket bridge supported-assets
# Überprüft den Einzahlungsstatus
polymarket bridge status DEPOSIT_ADDRESS
Portfolio-Daten
# Zeigt aktuelle Positionen an
polymarket data positions YOUR_WALLET_ADDRESS
# Zeigt geschlossene Positionen an
polymarket data closed-positions YOUR_WALLET_ADDRESS
# Gesamter Portfoliowert
polymarket data value YOUR_WALLET_ADDRESS
# Handelshistorie
polymarket data trades YOUR_WALLET_ADDRESS --limit 50
Verwendung von JSON-Ausgabe für Skripte
Eine der leistungsstärksten Funktionen der Polymarket CLI ist die JSON-Ausgabe, die sie perfekt für Skripterstellung und Automatisierung macht.
Einfache JSON-Ausgabe
# Ruft Märkte als JSON ab
polymarket -o json markets list --limit 10
Ausgabe:
[
{"id": "12345", "question": "Will BTC hit $100k?", "outcomePrices": ["0.67", "0.33"], ...},
{"id": "67890", "question": "Will ETH flip BTC?", "outcomePrices": ["0.12", "0.88"], ...}
]
Verwendung mit jq
# Extrahiert nur die Fragen
polymarket -o json markets list --limit 100 | jq '.[].question'
# Ruft spezifische Preisdaten ab
polymarket -o json clob midpoint TOKEN_ID | jq '.mid'
# Filtert Märkte nach Volumen
polymarket -o json markets list --limit 100 | jq '.[] | select(.volume_num > 1000000)'
Fehlerbehandlung in Skripten
#!/bin/bash
# Beispiel: Guthabenprüfung mit Fehlerbehandlung
if ! result=$(polymarket -o json clob balance --asset-type collateral 2>/dev/null); then
echo "Fehler beim Abrufen des Guthabens"
exit 1
fi
balance=$(echo "$result" | jq -r '.balance')
echo "Ihr Guthaben: $balance USDC"
Automatisierte Marktüberwachung
Einen einfachen Marktmonitor erstellen:
#!/bin/bash
# monitor-market.sh - Überwacht den Preis eines bestimmten Marktes
TOKEN_ID=$1
INTERVAL=${2:-60} # Standard 60 Sekunden
while true; do
clear
echo "Marktüberwachung: $(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
Ausführen mit: ./monitor-market.sh TOKEN_ID 30
Testen der Polymarket API mit Apidog
Beim Aufbau automatisierter Handelssysteme oder der Integration von Polymarket in Ihre Anwendungen ist ein umfassendes API-Testing unerlässlich. Apidog bietet eine leistungsstarke, All-in-One-API-Entwicklungsplattform, die das Testen von Prognosemarkt-APIs unkompliziert und effizient macht.
Warum Apidog für die Polymarket-Integration verwenden?
Egal, ob Sie einen Trading-Bot, ein Marktanalysedashboard oder Polymarket-Daten in Ihre Anwendung integrieren, Apidog bietet mehrere Vorteile:
- Visueller API-Client: Anfragen senden und Antworten überprüfen, ohne Code zu schreiben
- Automatisierte Tests: Test-Suites erstellen, um Ihre Handelslogik zu überprüfen
- Umgebungsvariablen: API-Endpunkte und Anmeldeinformationen über Entwicklungs-/Staging-/Produktionsumgebungen hinweg verwalten
- Zusammenarbeit: API-Definitionen mit Ihrem Team teilen
Interaktiver Shell-Modus
Für die interaktive Erkundung verwenden Sie die integrierte Shell:
polymarket shell
Dies öffnet eine interaktive REPL:
polymarket> markets list --limit 3
polymarket> clob book TOKEN_ID
polymarket> exit
Die Shell unterstützt die Befehlshistorie, was das Experimentieren mit verschiedenen Befehlen erleichtert.
Häufige Workflows
Workflow 1: Recherche und Handel
# Schritt 1: Interessante Märkte finden
polymarket markets search "bitcoin" --limit 10
polymarket markets get bitcoin-above-100k
# Schritt 2: Orderbuch und Preise überprüfen
polymarket clob book TOKEN_ID
polymarket clob price-history TOKEN_ID --interval 1d
# Schritt 3: Ihr Guthaben überprüfen
polymarket clob balance --asset-type collateral
# Schritt 4: Einen Trade platzieren
polymarket clob market-order --token TOKEN_ID --side buy --amount 10
Workflow 2: Portfolio-Management
# Alle Positionen anzeigen
polymarket data positions YOUR_ADDRESS
# Gesamtwert überprüfen
polymarket data value YOUR_ADDRESS
# Handelshistorie anzeigen
polymarket data trades YOUR_ADDRESS --limit 50
# Offene Aufträge überprüfen
polymarket clob orders
Workflow 3: Programmatischer Trading-Bot
#!/bin/bash
# Einfacher Bot: Kauft, wenn der Preis unter einen Schwellenwert fällt
TOKEN_ID="YOUR_TOKEN_ID"
THRESHOLD=0.45
AMOUNT=10
# Aktuellen Preis abrufen
PRICE=$(polymarket -o json clob midpoint $TOKEN_ID | jq -r '.mid')
# In Dezimalzahl umwandeln
PRICE_DECIMAL=$(echo "scale=2; $PRICE / 100" | bc)
if (( $(echo "$PRICE_DECIMAL < $THRESHOLD" | bc -l) )); then
echo "Preis ($PRICE_DECIMAL) unter Schwellenwert ($THRESHOLD) - kaufe"
polymarket clob market-order --token $TOKEN_ID --side buy --amount $AMOUNT
else
echo "Preis ($PRICE_DECIMAL) über Schwellenwert - halte"
fi
Sicherheitsüberlegungen
Beachten Sie bei der Verwendung der Polymarket CLI diese Best Practices für die Sicherheit:
Sicherheit des privaten Schlüssels
- Veröffentlichen Sie Ihren privaten Schlüssel niemals in der Versionskontrolle
- Verwenden Sie die Konfigurationsdatei anstelle von Umgebungsvariablen in gemeinsam genutzten Umgebungen
- Erwägen Sie die Integration einer Hardware-Wallet für große Guthaben
- Verwenden Sie eine separate Wallet für den CLI-Handel (nicht Ihre Haupt-Wallet)
Transaktionsprüfung
- Überprüfen Sie immer die Transaktionsdetails, bevor Sie bestätigen
- Beginnen Sie mit kleinen Beträgen, um Ihr Setup zu testen
- Halten Sie Ihr MATIC-Guthaben für Gasgebühren ausreichend
API-Schlüsselverwaltung
# Erstellt dedizierte API-Schlüssel für Skripte
polymarket clob create-api-key
# Listet und verwaltet Schlüssel
polymarket clob api-keys
# Löscht kompromittierte Schlüssel
polymarket clob delete-api-key
Netzwerksicherheit
- Verwenden Sie die CLI über HTTPS (Standard)
- Seien Sie vorsichtig bei der Verwendung privater Schlüssel in Cloud-Umgebungen
- Erwägen Sie die Verwendung eines VPN, wenn Sie von öffentlichen Netzwerken aus handeln
Fazit
Die Polymarket CLI ist ein leistungsstarkes Werkzeug für Entwickler, die programmatisch mit Prognosemärkten interagieren möchten. Egal, ob Sie ein Trader sind, der Strategien automatisieren möchte, ein Forscher, der Marktdaten analysiert, oder ein Entwickler, der Handelsbots erstellt, die CLI bietet eine robuste Schnittstelle zum Polymarket-Ökosystem.
Wichtige Erkenntnisse aus diesem Leitfaden:
- Installation über Homebrew oder Shell-Skript für eine schnelle Einrichtung
- Märkte ohne Wallet für Recherchen durchsuchen
- Wallet vor dem Handel korrekt konfigurieren
- JSON-Ausgabe für Skripterstellung und Automatisierung verwenden
- Sicherheit beim Umgang mit privaten Schlüsseln immer priorisieren
- Mit kleinen Trades beginnen, um Ihr Setup zu testen
- Apidog zum Testen und Validieren Ihrer Polymarket API-Integrationen verwenden
Für fortgeschrittenere Anwendungsfälle sollten Sie die Polymarket CLI mit anderen Tools wie cron für geplante Aufgaben, jq für die Datenverarbeitung oder benutzerdefinierten Bots, die in Python oder Node.js erstellt wurden, kombinieren. Beim Aufbau Ihrer Handelsintegration verwenden Sie Apidog, um alle API-Endpunkte gründlich zu testen, bevor Sie live gehen.
Testen Sie Apidog kostenlos, um Ihren API-Test-Workflow zu optimieren und Vertrauen in Ihre Polymarket-Integrationen aufzubauen.
FAQ
Ist die Polymarket CLI sicher zu verwenden?
Die Polymarket CLI ist experimentelle Software. Verwenden Sie sie mit Vorsicht und niemals mit großen Geldbeträgen. Überprüfen Sie Transaktionen immer, bevor Sie sie bestätigen. Das Projekt ist Open Source, sodass Sie den Code selbst überprüfen können.
Benötige ich eine Wallet, um Märkte zu durchsuchen?
Nein. Die meisten Befehle (Märkte, Ereignisse, CLOB-Preise, Orderbücher) funktionieren ohne Wallet. Eine Wallet benötigen Sie nur für das Platzieren von Aufträgen, das Überprüfen von Guthaben und On-Chain-Operationen.
Welche Blockchains unterstützt Polymarket?
Polymarket basiert auf Polygon (Ketten-ID 137). Die CLI handhabt sowohl On-Chain-Operationen (die MATIC für Gas erfordern) als auch Off-Chain-Auftragsplatzierungen.
Kann ich die Polymarket CLI für den automatisierten Handel verwenden?
Ja. Das JSON-Ausgabeformat macht sie ideal für die Skripterstellung. Sie können automatisierte Handelsbots mit Shell-Skripten, Python oder jeder Sprache erstellen, die CLI-Befehle ausführen und JSON parsen kann.
Wie erhalte ich Hilfe zur Polymarket CLI?
Überprüfen Sie das offizielle GitHub-Repository für Dokumentation und Problemverfolgung.
Unterstützt die Polymarket CLI Testnet?
Die aktuelle Version funktioniert mit der Haupt-Polymarket-Bereitstellung. Informationen zur Testnet-Unterstützung finden Sie im GitHub-Repository.
Was ist der Unterschied zwischen den Signaturtypen Proxy und EOA?
proxy (Standard) verwendet das Proxy-Wallet-System von Polymarket, das die Gasgebühren senken kann. eoa signiert direkt mit Ihrem privaten Schlüssel. Für die meisten Benutzer wird der Standard-Proxy-Typ empfohlen.
Wie aktualisiere ich die Polymarket CLI auf die neueste Version?
Führen Sie polymarket upgrade aus, um nach Updates zu suchen und diese zu installieren. Für Homebrew-Installationen verwenden Sie brew update && brew upgrade polymarket.
Kann ich Apidog zum Testen von Polymarket API-Aufrufen verwenden?
Ja. Apidog ist ein hervorragendes Tool zum Testen von Prognosemarkt-APIs. Erstellen Sie ein neues Projekt in Apidog, fügen Sie Ihre Polymarket-Endpunkte hinzu und verwenden Sie den visuellen Client, um Anfragen zu senden und Antworten zu überprüfen. Die Umgebungsvariablen von Apidog erleichtern die Verwaltung verschiedener API-Anmeldeinformationen, und Sie können automatisierte Testszenarien erstellen, um zu überprüfen, ob Ihre Handelslogik korrekt funktioniert.