Polymarket-Query (Read-Only)

Polymarket-Query

Ein schreibgeschützter Skill zur Recherche von Polymarket-Prognosemärkten (er platziert niemals Aufträge). Er deckt zwei Anforderungen ab:

• Marktforschung: heiße Events, Suche, Event-Detail, historische Preise und Wahrscheinlichkeits-/Volumen-Trends.
• Positions- & Wal-Verfolgung: Leaderboard, Positionen und P&L beliebiger Adressen sowie Handelshistorie.

Um tatsächlich zu kaufen/verkaufen (Aufträge platzieren, stornieren, Kontostände, Auftragsverwaltung), verwende den Skill polymarket-trade.

Kurzanleitung

1. Überprüfe die Umgebung: bash, curl, jq und Zugriff auf gamma-api.polymarket.com / data-api.polymarket.com / clob.polymarket.com.
2. Wähle einen Aufgabentyp: Marktinfo / Wale & Positionen / historische Trends.
3. Führe den passenden Befehl aus: bash <skill-verzeichnis>/scripts/polymarket.sh <befehl> [argumente…].

Vollständige Befehlsliste: references/commands.md. Fehlerbehebung: references/troubleshooting.md.

Befehlsauswahl

• Schnelle Marktübersicht: hot [limit].
• Märkte nach Stichwort suchen: search <suchbegriff> [limit].
• Event mit Slugs (mit Tokens) überprüfen: detail <event-slug>.
• Top-Trader verfolgen / Positionen prüfen: leaderboard (Alias lb) → positions (Alias pos) → trades.
  • Nur offene Positionen: positions <adresse> [limit] --active.
  • Eigene Wallet: mit gesetzter POLYMARKET_FUNDER (oder FUNDER) verwenden positions / trades standardmäßig diese Adresse, wenn keine angegeben ist. Verwende deine Proxy-Wallet-Adresse (die Gelder/Positionen hält), nicht die Signer-/EOA-Adresse.
• Zeitreihenüberprüfung:
  • Wahrscheinlichkeitstabelle: history
  • Start/Ende-Änderungszusammenfassung: trend
  • Volumenänderungen: volume-trend
• Dateiexport: Füge --format csv|json und optional --out <datei> zu history/trend/volume-trend hinzu.

Minimale Beispiele

# 1) Heiße Märkte
bash <skill-verzeichnis>/scripts/polymarket.sh hot 5

# 2) Suche + Detail
bash <skill-verzeichnis>/scripts/polymarket.sh search bitcoin 5
bash <skill-verzeichnis>/scripts/polymarket.sh detail fed-decision-in-march-885

# 3) Wal- & Positionsverfolgung
bash <skill-verzeichnis>/scripts/polymarket.sh lb 10 pnl week
bash <skill-verzeichnis>/scripts/polymarket.sh pos 0xc257ea... 10
bash <skill-verzeichnis>/scripts/polymarket.sh pos 0xc257ea... 10 --active   # nur offene
bash <skill-verzeichnis>/scripts/polymarket.sh trades 0xc257ea... 10

# 4) Historische Trends + Export
bash <skill-verzeichnis>/scripts/polymarket.sh history fed-decision-in-march-885 2025-01-01 2025-01-31 1d
bash <skill-verzeichnis>/scripts/polymarket.sh trend fed-decision-in-march-885 2025-01-01 2025-01-31 --format csv
bash <skill-verzeichnis>/scripts/polymarket.sh volume-trend fed-decision-in-march-885 2025-01-01 2025-01-31 --format json --out /tmp/volume.json

Parameterregeln: von/bis sind im Format YYYY-MM-DD; intervall ist 1h / 4h / 1d.

Häufige Fehler

• Fehlende Abhängigkeiten: Installiere curl / jq.
• Netzwerkfehler: Überprüfe die API-Erreichbarkeit und Timeouts; erhöhe CURL_TIMEOUT falls nötig. In einer Proxy-Umgebung wird HTTPS_PROXY automatisch erkannt.
• Fehler bei historischen Preisen: Überprüfe POLYMARKET_BEARER_TOKEN oder eine Anmeldedatei (siehe unten).
• Argumentfehler: Überprüfe die Befehlsverwendung und das Datumsformat (YYYY-MM-DD).

Anmeldedaten (nur der historische Preis-Endpunkt benötigt einen)

Der historische Preis-Endpunkt erfordert möglicherweise einen Bearer-Token. Er wird in dieser Reihenfolge aufgelöst (agentenunabhängig, nicht an eine bestimmte Laufzeitumgebung gebunden):

1. Umgebungsvariable POLYMARKET_BEARER_TOKEN
2. Die durch POLYMARKET_CREDENTIALS_FILE benannte Datei
3. ./.credentials im Projektverzeichnis (sollte in .gitignore sein)
4. ~/.config/holo-polymarket/credentials
5. ~/.openclaw/credentials/polymarket_credentials (Legacy-Fallback)

Die Anmeldedatei ist im Format SCHLÜSSEL=WERT und unterstützt die Felder BEARER_TOKEN / TOKEN.

Dieselbe Datei (oder Umgebungsvariable) kann auch POLYMARKET_FUNDER / FUNDER bereitstellen – deine eigene Proxy-Wallet-Adresse. Wenn gesetzt, verwenden positions / trades standardmäßig diese Adresse, falls keine auf der Befehlszeile angegeben ist. Dies ist die einzige Identität, die der Query-Skill liest; alles andere hier ist schreibgeschützt und öffentlich.

Handelsgrenze

Dieser Skill ist schreibgeschützt und platziert niemals Aufträge. Für Kaufen/Verkaufen, Stornieren, Kontostände und Auftragsverwaltung verwende den Skill polymarket-trade (basierend auf der offiziellen CLOB-API).