Nutze die Stock Events API

Die Stock Events API ist ein Pro-Feature, mit dem du Daten in deinem Stock Events Account über deine eigenen Tools automatisieren kannst. Sie ist für die Account-Automatisierung gedacht und nicht als allgemeine Marktdaten- oder Symbol-Such-API.

Write-Requests ändern dieselben Watchlists, Symbole und Transaktionen, die du auch in Stock Events siehst.

Was du mit der API machen kannst

• Watchlists auflisten, erstellen, abrufen und aktualisieren.
• Symbole in einer Watchlist auflisten, hinzufügen, aktualisieren und entfernen.
• Transaktionen auflisten, erstellen, abrufen, aktualisieren und löschen.
• Berechnete Ansichten für Holdings und Dividenden lesen.

So erstellst du einen API-Key

Du benötigst ein aktives Stock Events Pro-Abo, um API-Keys zu erstellen und zu nutzen.

1. Melde dich in der Stock Events Web-App an.
2. Öffne dein Profil.
3. Wähle Einstellungen.
4. Wähle unter Account den Punkt Daten aus.
5. Wähle API Keys.
6. Wähle API-Key erstellen.
7. Gib einen beschreibenden Namen ein und wähle dann Erstellen.
8. Wähle API-Key kopieren und speichere den Key sicher ab, bevor du das Dialogfenster schließt.

Der vollständige API-Key wird nur ein einziges Mal angezeigt. Nachdem du das Fenster geschlossen hast, zeigt der API-Keys-Bildschirm nur noch den Namen, das Präfix, das Erstellungsdatum und das Datum der letzten Nutzung an, anstatt des kompletten Keys.

Falls dein Pro-Abo inaktiv wird, bleiben deine Keys mit deinem Account verknüpft, aber API-Requests geben 403 Forbidden zurück, bis der Pro-Zugriff wieder aktiv ist.

Mach deinen ersten Request

Die API Base URL ist https://stockevents.app/api/v1. Sende deinen API-Key als Bearer-Token im Authorization Header.

curl -H "Authorization: Bearer $STOCK_EVENTS_API_KEY" \ 
  https://stockevents.app/api/v1/watchlists

Dieser Request gibt deine Watchlists und deren IDs zurück. Du kannst eine Watchlist-ID zusammen mit den watchlist-spezifischen Endpoints für Symbole, Holdings und Dividenden verwenden.

Für Request-Felder, Response-Strukturen, optionale Parameter und alle verfügbaren Endpoints nutze bitte diese Ressourcen:

• Stock Events API Dokumentation
• API Keys Einstellungen
• OpenAPI Dokument

Halte deinen API-Key sicher

Behandle einen API-Key wie ein Passwort. Committe ihn nicht in die Source Control, zeige ihn nicht in öffentlichem Client-Code und sende ihn nicht in einem Query-Parameter oder Request-Body.

API-Keys authentifizieren die Account-Automatisierungs-API ohne separate Berechtigungen für jeden einzelnen Key. Nutze sie nur mit Tools, denen du vertraust.

Falls ein Key doch einmal öffentlich wird, geh zurück zu API Keys, wähle API-Key widerrufen und bestätige mit Widerrufen. Der Key funktioniert sofort nicht mehr und kann nicht reaktiviert werden. Erstelle bei Bedarf einfach einen neuen Key.

Häufige Fehler

• 401 Unauthorized: Der API-Key fehlt, ist ungültig oder wurde widerrufen.
• 403 Forbidden: Der Account hat aktuell keinen aktiven Pro-Zugriff.