Public API
REST-API-Schlüssel für programmatischen Zugriff (Bot-Plan)
Die Predite Public API erlaubt dir, deine eigenen Daten programmatisch auszulesen — dein Live-Portfolio und die aktuellen Expected-Value-Signale — aus deinen eigenen Skripten, Tabellen oder Trading-Tools. Es ist eine reine Lese-REST-API, abgesichert mit einem persönlichen API-Key und verfügbar im Bot-Tarif.
Keys erstellst und verwaltest du im Dashboard unter Einstellungen auf der Seite API.
Einen API-Key erstellen
Gib dem Key ein Label (zum Beispiel „sheet import“ oder „backtest script“) und erstelle ihn. Ein paar Dinge, die du wissen solltest:
- •Der vollständige Key wird nur einmal angezeigt, direkt bei der Erstellung. Er sieht aus wie pdt_live_ gefolgt von einer zufälligen Zeichenfolge. Kopiere ihn sofort und bewahre ihn sicher auf — er wird nie wieder angezeigt, weil auf unseren Servern nur ein Hash davon liegt.
- •Nach der Erstellung zeigt das Dashboard nur noch das kurze Präfix des Keys, damit du deine Keys auseinanderhalten kannst.
- •Jeder Key ist schreibgeschützt und läuft ein Jahr nach der Erstellung ab. Wir erinnern dich rechtzeitig daran.
- •Du kannst einen Key jederzeit widerrufen. Der Widerruf greift sofort — jedes Skript, das ihn noch nutzt, bekommt ab dann 401 Unauthorized.
Authentifizierung
Schicke den Key bei jeder Anfrage als Bearer-Token im Authorization-Header:
Authorization: Bearer pdt_live_your_key_here
Ein fehlender oder ungültiger Key ergibt HTTP 401. Anfragen sind pro Client rate-limitiert — wenn du zu viele zu schnell schickst, bekommst du HTTP 429 mit einem Retry-After-Header, der dir sagt, wie viele Sekunden du warten musst. Halte das Polling bei wenigen Anfragen pro Minute und cache, was du abrufst; diese Daten ändern sich nicht im Sekundentakt.
Endpunkte
Aktuell stehen zwei GET-Endpunkte zur Verfügung, beide liefern JSON.
GET /api/v1/portfolio
Liefert die offenen Positionen des Polymarket-Wallets, das mit deinem Konto verbunden ist, dazu eine Zusammenfassung und einen generated_at-Zeitstempel. Wenn du noch kein Wallet verbunden und verifiziert hast, kommt das positions-Array leer zurück, mit dem Fehler no_wallet_connected — verbinde also zuerst eines (siehe Wallet verbinden).
GET /api/v1/signals
Liefert die aktuell besten Expected-Value-Signale, sortiert nach Edge. Zwei optionale Query-Parameter:
- •limit — wie viele Signale zurückkommen sollen, von 1 bis 100 (Standard 20)
- •min_edge — der minimale Edge in Prozentpunkten (Standard 5)
Die Antwort enthält das signals-Array, einen count, die von dir gesetzten Filter und einen generated_at-Zeitstempel.
Beispiel
Eine minimale Anfrage mit curl, die nach den zehn stärksten Signalen mit mindestens sechs Punkten Edge fragt:
curl -H "Authorization: Bearer pdt_live_..." "https://predite.io/api/v1/signals?limit=10&min_edge=6"
Gut zu wissen
- •Die API ist schreibgeschützt — es gibt keine Trading- oder Schreib-Endpunkte. Orders werden immer aus der App heraus platziert, ein geleakter Key kann also niemals dein Geld bewegen.
- •Behandle den Key trotzdem wie ein Passwort. Wenn er nach außen gerät, widerrufe ihn und erstelle einen neuen.
- •Lieber Alerts, die zu dir gepusht werden, statt Polling? Verbinde dein Konto mit Telegram und lass die Signale zu dir kommen.