Polymarket
Durchsuchen Sie Polymarket-Prognosemärkte und handeln Sie direkt vom Terminal aus. Sehen Sie Quoten ein, recherchieren Sie Ereignisse, vergleichen Sie Märkte, verfolgen Sie Ihr Portfolio, streamen Sie Live-Daten, überbrücken Sie Gelder und führen Sie Trades aus – alles über natürliche Sprache.
Polymarket stellt 4 separate APIs sowie die Gamma-Komfortschicht bereit. Dieses Skill deckt alle ab.
Einrichtung
Nur-Lesen-Befehle funktionieren sofort (keine Installation erforderlich). Das Durchsuchen, Suchen, Trends, Kategorien, Marktforschung und der Vergleichsmodus verwenden alle die öffentliche Gamma-API.
Für den Handel, Orderbücher, Preishistorie und erweiterte Funktionen installieren Sie die Polymarket-CLI (Rust-Binärdatei, v0.1.5+):
brew install polymarket/tap/polymarket-cli
Für den Handel richten Sie eine Wallet ein:
polymarket wallet create
polymarket approve set
Oder konfigurieren Sie ~/.config/polymarket/config.json manuell mit Ihrem privaten Schlüssel. Details finden Sie in der CLI-Dokumentation.
Die CLI bietet auch eine interaktive REPL:
polymarket shell
Verwenden Sie --output json bei jedem CLI-Befehl für maschinenlesbare Ausgabe, die sich für Skripte und Pipes eignet.
Befehle
Märkte durchsuchen (keine CLI erforderlich)
# Trend-/aktive Märkte (sortiert nach 24h-Volumen)
python3 {baseDir}/scripts/polymarket.py trending
# Trend mit mehr Ergebnissen
python3 {baseDir}/scripts/polymarket.py trending --limit 20
# Märkte nach Stichwort durchsuchen
python3 {baseDir}/scripts/polymarket.py search "trump"
# Bestimmtes Ereignis nach Slug abrufen
python3 {baseDir}/scripts/polymarket.py event "fed-decision-in-october"
# Märkte nach Kategorie abrufen
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
Trendmarkt-Dashboard (keine CLI erforderlich)
Zeigen Sie ein kategorisiertes Dashboard der heißesten Märkte auf Polymarket an. Kombinieren Sie Trends mit Kategoriefiltern, um einen vollständigen Überblick zu erhalten.
# Vollständiges Trend-Dashboard – führen Sie diese in Folge aus, um ein Bild zu erhalten:
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
Wenn der Benutzer nach einem "Dashboard" oder "Überblick" fragt, führen Sie alle Kategorieabfragen aus und präsentieren Sie die Ergebnisse gruppiert nach Abschnitten mit klaren Überschriften. Geben Sie Volumen und aktuelle Quoten für jeden Markt an.
Marktforschungsmodus (keine CLI erforderlich)
Die Marktforschung kombiniert Polymarket-Quoten mit kontextueller Analyse. Wenn der Benutzer einen Markt "recherchieren" möchte oder eine tiefere Analyse über die reinen Quoten hinaus wünscht:
- Marktdaten abrufen – Verwenden Sie Such- oder Ereignisbefehle
- Quoten analysieren – Was impliziert der Markt? Gibt es einen Edge?
- Kontext bereitstellen – Nutzen Sie Ihr Wissen, um zu erklären, was die Quoten antreibt
- Historische Bewegung anzeigen – Wenn CLI verfügbar ist, Preishistorie abrufen
- Mit Konsens vergleichen – Wie verhalten sich Polymarket-Quoten zu Umfragen, Expertenmeinungen oder anderen Prognosemärkten?
# Schritt 1: Markt finden
python3 {baseDir}/scripts/polymarket.py search "fed rate cut"
# Schritt 2: Detaillierte Ereignisdaten abrufen
python3 {baseDir}/scripts/polymarket.py event "fed-rate-decision-march-2026"
# Schritt 3: Wenn CLI verfügbar, Preishistorie abrufen, um den Trend zu zeigen
python3 {baseDir}/scripts/polymarket.py price-history TOKEN_ID --interval 1d
# Schritt 4: Orderbuchtiefe für Liquiditätsbewertung prüfen
python3 {baseDir}/scripts/polymarket.py book TOKEN_ID
Nach dem Sammeln der Daten fassen Sie die Forschung in einem strukturierten Bericht zusammen:
- Aktuelle Quoten: Ja/Nein-Prozentsätze und was sie implizieren
- Volumen & Liquidität: Wie viel Geld steckt in diesem Markt? Ist er liquide genug zum Handeln?
- Trend: Bewegen sich die Quoten nach oben oder unten? Gab es kürzliche Spitzen?
- Kontext: Welche realen Ereignisse oder Datenpunkte treiben die Quoten?
- Wichtige Daten: Wann wird der Markt aufgelöst? Stehen bevorstehende Katalysatoren an?
- Risikofaktoren: Was könnte eine plötzliche Bewegung verursachen?
Marktvergleichsmodus (keine CLI erforderlich)
Vergleichen Sie verwandte Märkte nebeneinander. Nützlich zum Finden von Arbitrage, zum Verständnis bedingter Wahrscheinlichkeiten oder einfach zum Erkennen, wie verschiedene Ergebnisse zusammenhängen.
# Vergleichen Sie zwei oder mehr verwandte Märkte, indem Sie nach jedem suchen
python3 {baseDir}/scripts/polymarket.py search "trump 2028"
python3 {baseDir}/scripts/polymarket.py search "desantis 2028"
python3 {baseDir}/scripts/polymarket.py search "newsom 2028"
Wenn der Benutzer "Märkte vergleichen" oder "Quoten nebeneinander" möchte:
- Suchen Sie nach jedem vom Benutzer genannten Markt
- Präsentieren Sie die Quoten in einem Vergleichstabellenformat
- Notieren Sie Volumenunterschiede (höheres Volumen = zuverlässigere Quoten)
- Kennzeichnen Sie offensichtliche Inkonsistenzen (z. B. Wahrscheinlichkeiten, die sich nicht auf ~100 % summieren)
- Heben Sie die Spanne zwischen verwandten Ergebnissen hervor
Formatieren Sie den Vergleich als Tabelle:
Marktvergleich: Präsidentschaftswahl 2028
| Kandidat | Ja | Volumen | Liquidität |
|---------------|---------|----------|------------|
| Trump | 32,5 % | 4,2 Mio.$ | Hoch |
| DeSantis | 18,1 % | 1,8 Mio.$ | Mittel |
| Newsom | 12,4 % | 890.000$ | Mittel |
| Harris | 8,7 % | 2,1 Mio.$ | Mittel |
Portfolio-Dashboard (CLI + Wallet erforderlich)
Zeigen Sie Ihr gesamtes Portfolio mit Positionen, Gewinn/Verlust und offenen Aufträgen in einer Ansicht an.
# Alle offenen Positionen anzeigen
python3 {baseDir}/scripts/polymarket.py positions
# Positionen für eine bestimmte Wallet anzeigen
python3 {baseDir}/scripts/polymarket.py positions --address 0xYOUR_WALLET
# USDC-Guthaben prüfen
python3 {baseDir}/scripts/polymarket.py wallet-balance
# Guthaben für einen bestimmten Token prüfen
python3 {baseDir}/scripts/polymarket.py wallet-balance --token TOKEN_ID
# Alle offenen Aufträge auflisten
python3 {baseDir}/scripts/polymarket.py orders
Wenn der Benutzer nach einem "Portfolio-Dashboard" oder "wie läuft es bei mir" fragt, führen Sie alle drei Befehle (positions, wallet-balance, orders) aus und präsentieren Sie eine einheitliche Ansicht:
- Positionen: Jede Position mit aktuellem Marktpreis, Ihrem Einstiegspreis (falls verfügbar) und nicht realisiertem Gewinn/Verlust
- USDC-Guthaben: Verfügbares Bargeld für neue Trades
- Offene Aufträge: Ausstehende Limitaufträge mit Preis und Größe
- Portfoliogesamtwert: Summe der Positionen + USDC-Guthaben
Orderbuch & Preise (CLI erforderlich, keine Wallet)
# Orderbuch für einen Token
python3 {baseDir}/scripts/polymarket.py book TOKEN_ID
# Preishistorie (Intervalle: 1m, 1h, 6h, 1d, 1w, max)
python3 {baseDir}/scripts/polymarket.py price-history TOKEN_ID --interval 1d
# Preishistorie mit einer bestimmten Anzahl von Datenpunkten
python3 {baseDir}/scripts/polymarket.py price-history TOKEN_ID --interval 1h --fidelity 48
Wallet (CLI erforderlich)
polymarket wallet create
polymarket wallet show
polymarket wallet balance
polymarket wallet balance --token TOKEN_ID
Handel (CLI + Wallet erforderlich)
Alle Trades erfordern --confirm zur Ausführung. Ohne diesen wird der Auftrag nur in der Vorschau angezeigt. Dies ist eine Sicherheitsfunktion – Sie sehen immer, was passieren wird, bevor es passiert.
Kosten- und Gebührentransparenz
Vor der Ausführung eines Trades zeigt das Skill Folgendes an:
- Auftragstyp: Limit oder Market
- Seite: Kaufen oder Verkaufen
- Preis: Ihr Limitpreis (oder "market" für Marktaufträge)
- Größe: Anzahl der Anteile
- Geschätzte Kosten: Preis x Größe für Limitaufträge oder Betrag in Dollar für Marktaufträge
- Polymarket-Gebühr: Polymarket erhebt keine Handelsgebühren auf dem CLOB (Central Limit Order Book)
- Gas-Gebühren: On-Chain-Operationen (Genehmigungen, Splits, Einlösungen) erfordern MATIC für Gas auf Polygon. Typisches Gas: 0,01-0,05 $
# Vorschau eines Limitauftrags (ohne --confirm = nur Vorschau)
python3 {baseDir}/scripts/polymarket.py trade buy --token TOKEN_ID --price 0.50 --size 10
# Ausführung eines Limitauftrags
python3 {baseDir}/scripts/polymarket.py --confirm trade buy --token TOKEN_ID --price 0.50 --size 10
# Verkaufs-Limitauftrag
python3 {baseDir}/scripts/polymarket.py --confirm trade sell --token TOKEN_ID --price 0.70 --size 10
# Marktauftrag: 5 $ zum aktuellen Preis kaufen
python3 {baseDir}/scripts/polymarket.py --confirm trade buy --token TOKEN_ID --market-order --amount 5
# Post-Only-Limitauftrag (ruht nur im Orderbuch, nimmt niemals Liquidität – Jan 2026+)
python3 {baseDir}/scripts/polymarket.py --confirm trade buy --token TOKEN_ID --price 0.45 --size 20 --post-only
Aufträge & Positionen (CLI + Wallet erforderlich)
# Offene Aufträge auflisten
python3 {baseDir}/scripts/polymarket.py orders
# Einen bestimmten Auftrag stornieren
python3 {baseDir}/scripts/polymarket.py --confirm orders --cancel ORDER_ID
# Alle Aufträge stornieren
python3 {baseDir}/scripts/polymarket.py --confirm orders --cancel all
# Positionen anzeigen
python3 {baseDir}/scripts/polymarket.py positions
python3 {baseDir}/scripts/polymarket.py positions --address 0xYOUR_WALLET
API-Referenz
Polymarket stellt 4 verschiedene APIs plus die Gamma-Komfortschicht bereit. Jede dient einem anderen Zweck.
1. Gamma-API (gamma-api.polymarket.com) – Öffentlich, keine Authentifizierung
Die High-Level-Komfort-API zum Durchsuchen und Suchen von Märkten. Wird von allen Nur-Lesen-Befehlen verwendet.
- Basis-URL:
https://gamma-api.polymarket.com GET /events– Ereignisse auflisten (Parameter:order,ascending,closed,limit,tag_slug)GET /search– Märkte durchsuchen (Parameter:query,limit)GET /events/slug/{slug}– Ereignis nach SlugGET /comments– Kommentare zu Märkten auflisten und filternGET /profiles/{address}– Öffentliche BenutzerprofileGET /series– Gruppierte Ereignissammlungen (z. B. Serie "Wahl 2028")GET /sports– Sport-Metadaten mit Teams, Spielen und Auflösungskriterien- GraphQL:
POST /query– Vollständiger GraphQL-Endpunkt mit Abonnementunterstützung
2. CLOB-API (clob.polymarket.com) – Handel
Die Central Limit Order Book-API für alle Handelsvorgänge. Wird von der Polymarket-CLI gekapselt.
- Basis-URL:
https://clob.polymarket.com GET /prices-history– Historische Preise (Intervalle:1m,1h,6h,1d,1w,max)GET /spread– Geld-Brief-Spanne für einen TokenGET /fee-rate– Details zur GebührenstrukturGET /rewards– Tägliche Maker/Taker-ErträgePOST /order– Auftrag platzierenPOST /orders– Auftragssammlungen (bis zu 15 pro Anfrage)DELETE /order/{id}– Auftrag stornieren- Auftragsbewertung – Prüfen Sie die Maker-Rabattberechtigung, bevor Sie Aufträge platzieren
- Post-Only-Aufträge (Jan 2026) – Aufträge, die nur im Orderbuch ruhen, niemals die Spanne überschreiten
- Heartbeat-API (Jan 2026):
POST /heartbeat– Muss innerhalb von 10 Sekunden gesendet werden, sonst werden alle offenen Aufträge automatisch storniert- Wird von Market Makern verwendet, um die Auftragspräsenz aufrechtzuerhalten
- Wenn der Heartbeat ausfällt, werden alle ruhenden Aufträge für diesen API-Schlüssel storniert
3. Data-API (data-api.polymarket.com) – Portfolio & Analysen
Die dedizierte API für Portfolio-Tracking, Handelshistorie und Marktanalysen. Keine Authentifizierung für öffentliche Endpunkte erforderlich.
- Basis-URL:
https://data-api.polymarket.com GET /positions?user={address}– Aktuelle offene Positionen- Sortieren nach:
TOKENS,CURRENT,INITIAL,CASHPNL,PERCENTPNL
- Sortieren nach:
GET /closed-positions?user={address}– Historische geschlossene PositionenGET /activity?user={address}– Aktivitätsfeed- Typen:
TRADE,SPLIT,MERGE,REDEEM,REWARD
- Typen:
GET /value?user={address}– Portfoliobewertung in USDGET /trades– Handelshistorie- Filtern nach:
user,market,side - Maximal 500 Ergebnisse pro Seite
- Filtern nach:
GET /holders?market={conditionId}– Top-Token-Inhaber für einen MarktGET /oi– Offenes Interesse über Märkte hinwegGET /volume– Handelsvolumen über Märkte hinwegGET /leaderboard– Händler-Rankings (konfigurierbarer Zeitraum)
Verwenden Sie die Data-API für Portfolio-Dashboards und Analysen. Sie liefert umfangreichere Positionsdaten als die CLOB-API, einschließlich Gewinn-/Verlustberechnungen und Aktivitätsverlauf.
4. RTDS WebSocket (wss://ws-live-data.polymarket.com) – Echtzeit-Streaming
Echtzeit-Daten-Streaming über WebSocket. Abonnieren Sie Themen für Live-Updates ohne Abfragen.
- URL:
wss://ws-live-data.polymarket.com - Protokoll: JSON-Nachrichten über WebSocket
- Themen:
comments– Echtzeit-Kommentaraktivität- Ereignisse:
comment_created,comment_removed,reaction_created,reaction_removed
- Ereignisse:
crypto_prices– Echtzeit-Kryptowährungspreise- Assets: BTC, ETH, SOL, XRP
- Quellen: Binance + Chainlink-Orakel
- Dynamisches Abonnementmanagement – Themen innerhalb einer einzigen Verbindung dynamisch abonnieren und kündigen
- Nützlich zum Erstellen von Live-Dashboards, Überwachen der Kommentarstimmung oder Verfolgen von Kryptopreisen, die in 5-Minuten-Kryptomärkte einfließen
5. Bridge-API (bridge.polymarket.com) – Cross-Chain-Einzahlungen & -Auszahlungen
Überbrücken Sie Gelder in und aus Polymarket über mehrere Chains.
- Basis-URL:
https://bridge.polymarket.com POST /deposit– Einzahlungsadressen generieren- Unterstützte Chains: EVM (Ethereum, Polygon, Arbitrum usw.), Solana, Bitcoin
- Gibt eine eindeutige Einzahlungsadresse für die ausgewählte Chain zurück
POST /withdraw(Jan 2026) – USDC.e in jede unterstützte Chain überbrückenGET /supported-assets– Alle unterstützten Assets und Chains auflistenGET /quote– Cross-Chain-Brückenangebote abrufen (Gebühren, geschätzte Zeit)
Verwenden Sie die Bridge-API, wenn ein Benutzer Gelder in oder aus Polymarket bewegen möchte, ohne das Terminal zu verlassen.
Neue Markttypen
- 5-Minuten-Kryptomärkte (Feb 2026) – Extrem kurzfristige Märkte für BTC/ETH/SOL-Kursbewegungen. Gespeist von RTDS crypto_prices-Daten.
- Sportmärkte – Dedizierte Sport-Metadaten über den Gamma
/sports-Endpunkt mit Teaminformationen, Spielplänen und Auflösungskriterien.
Fehlerbehebung
API-Fehler (Gamma-API)
Wenn die Gamma-API einen Fehler zurückgibt oder nicht erreichbar ist:
- HTTP 429 (Ratenbegrenzung) – Sie machen zu viele Anfragen. Warten Sie einige Sekunden und versuchen Sie es erneut. Die Gamma-APIs sind öffentlich, daher unterliegen sie einer Ratenbegrenzung.
- HTTP 500 / 502 / 503 – Serverfehler von Polymarket. Warten Sie einen Moment und versuchen Sie es erneut.
- Zeitüberschreitung – Der Server antwortet nicht. Versuchen Sie es erneut, nachdem Sie die Netzwerkverbindung überprüft haben.
CLI-Fehler
Wenn die Polymarket-CLI einen Fehler zurückgibt:
- "Befehl nicht gefunden" – Die CLI ist nicht installiert oder nicht im PATH. Installieren Sie sie mit
brew install polymarket/tap/polymarket-cli. - "Nicht autorisiert" – Der API-Schlüssel oder das Wallet ist nicht konfiguriert. Führen Sie
polymarket wallet createaus. - "Ungültiger Token" – Die Token-ID ist falsch oder abgelaufen. Überprüfen Sie die Token-ID mit einem Suchbefehl.
Fehler bei der Auftragsausführung
Wenn ein Trade fehlschlägt:
- "Ungenügendes Guthaben" – Sie haben nicht genug USDC oder MATIC. Überprüfen Sie Ihr Guthaben mit
polymarket wallet balance. - "Preis außerhalb des Bereichs" – Der Limitpreis liegt außerhalb des zulässigen Bereichs (zu weit vom aktuellen Preis entfernt). Passen Sie den Preis an.
- "Auftrag zu groß/klein" – Die Auftragsgröße liegt außerhalb des minimalen/maximalen Limits. Passen Sie die Größe an.
- "Zeitüberschreitung der Transaktion" – Die On-Chain-Transaktion wurde nicht innerhalb des Zeitlimits bestätigt. Versuchen Sie es erneut oder erhöhen Sie das Gaslimit.
Tipps & Tricks
- Maschinenlesbare Ausgabe: Verwenden Sie
--output jsonbei jedem CLI-Befehl, um strukturiertes JSON für Skripte zu erhalten. - Kombinieren von Befehlen: Sie können jeden Befehl mit anderen shell-Tools wie
jq,grepodersortkombinieren. - Aliase erstellen: Fügen Sie Aliase zu Ihrer
.bashrcoder.zshrchinzu:alias poly-trend='python3 /path/to/scripts/polymarket.py trending' alias poly-search='python3 /path/to/scripts/polymarket.py search' alias poly-portfolio='python3 /path/to/scripts/polymarket.py positions && python3 /path/to/scripts/polymarket.py wallet-balance && python3 /path/to/scripts/polymarket.py orders' - Live-Überwachung: Kombinieren Sie WebSocket-Stream mit einem Dashboard-Tool für Echtzeit-Updates.
- Sicherheit: Teilen Sie niemals Ihre privaten Schlüssel oder API-Tokens. Verwenden Sie Umgebungsvariablen oder sichere Konfigurationsdateien.
Fehlerbehebung
API-Fehler (Gamma-API)
Wenn die Gamma-API einen Fehler zurückgibt oder nicht erreichbar ist:
- HTTP 429 (Ratenbegrenzung) – Sie machen zu viele Anfragen. Warten Sie einige Sekunden und versuchen Sie es erneut.
- HTTP 500 / 502 / 503 – Serverfehler von Polymarket. Warten Sie einen Moment und versuchen Sie es erneut.
- Zeitüberschreitung – Der Server antwortet nicht. Versuchen Sie es erneut, nachdem Sie die Netzwerkverbindung überprüft haben.
CLI-Fehler
Wenn die Polymarket-CLI einen Fehler zurückgibt:
- "Befehl nicht gefunden" – Die CLI ist nicht installiert oder nicht im PATH. Installieren Sie sie mit
brew install polymarket/tap/polymarket-cli. - "Nicht autorisiert" – Der API-Schlüssel oder das Wallet ist nicht konfiguriert. Führen Sie
polymarket wallet createaus. - "Ungültiger Token" – Die Token-ID ist falsch oder abgelaufen. Überprüfen Sie die Token-ID mit einem Suchbefehl.
Fehler bei der Auftragsausführung
Wenn ein Trade fehlschlägt:
- "Ungenügendes Guthaben" – Sie haben nicht genug USDC oder MATIC. Überprüfen Sie Ihr Guthaben mit
polymarket wallet balance. - "Preis außerhalb des Bereichs" – Der Limitpreis liegt außerhalb des zulässigen Bereichs (zu weit vom aktuellen Preis entfernt). Passen Sie den Preis an.
- "Auftrag zu groß/klein" – Die Auftragsgröße liegt außerhalb des minimalen/maximalen Limits. Passen Sie die Größe an.
- "Zeitüberschreitung der Transaktion" – Die On-Chain-Transaktion wurde nicht innerhalb des Zeitlimits bestätigt. Versuchen Sie es erneut oder erhöhen Sie das Gaslimit.
Lizenz
Dieses Projekt ist unter der MIT-Lizenz lizenziert. Siehe die LICENSE-Datei für Details.