my_secondary_market_orders

Listet die eigenen Kauf- und Verkaufsaufträge des angemeldeten Benutzers auf dem Aktionariat-Sekundärmarkt für ein bestimmtes Emissionsunternehmen auf. Aufträge sind nach dem neuesten zuerst sortiert und enthalten einen abgeleiteten status, damit der Agent offen / storniert / erfüllt / abgelaufen bewerten kann, ohne ihn aus Rohfeldern neu abzuleiten.

Authentifizierung

Erfordert Anmeldung. Rufen Sie zunächst sign_in auf, wenn die Sitzung anonym ist.

Eingaben

Feld	Typ	Erforderlich	Beschreibung
company	integer	Ja	Emittent-Unternehmens-ID, deren Auftragsbuch abgefragt werden soll. Ermitteln Sie das Ticker über list_tokens.

Ausgabe

Eine Zusammenfassungs-Envelope mit der Unternehmens-ID, einer Anzahl und der Auftragsliste:

Feld	Typ	Beschreibung
companyId	integer	Die Unternehmens-ID, zu der die Aufträge gehören.
count	integer	Anzahl der zurückgegebenen Aufträge.
items	array	Aufträge, sortiert nach dem neuesten zuerst.

Jede Zeile in items enthält:

Feld	Typ	Beschreibung
id	string	Auftrags-ID, wie vom Backend zugewiesen.
side	string	buy oder sell.
status	string	open · cancelled · filled · expired.
price	number	Preis pro Aktie in der Währung der Aktiengattung (typischerweise ZCHF).
totalShares	integer	Ursprüngliche Auftragsgröße in Aktien.
remainingShares	integer	Noch offene Aktien.
filledShares	integer	Bereits erfüllte Aktien.
filledPercent	number	Erfüllungsquote in Prozent.
total	number	Verbleibender Auftragswert (= price * remainingShares) in der Quotierungswährung.
whenCreated	string	ISO-Zeitstempel.
whenExpires	string	ISO-Zeitstempel.
whenCancelled	string	ISO-Zeitstempel, nur gesetzt, wenn Status cancelled ist.

Wallet-Freigabe- und Fondsbestandsfelder, die von den Web-UI-Affordanzen “fehlende Freigabe” / “fehlende Mittel” verwendet werden, sind absichtlich ausgeschlossen — sie sind für einen Agent nicht nützlich.

Beispiel-Prompts

• “Zeige mir meine offenen Aufträge für das Aktionariat AG Token.”
• “Wie viel meines DAKS-Verkaufsauftrags ist noch nicht erfüllt?”
• “Liste meine stornierten Aufträge bei DAKS in diesem Jahr auf.”
• “Was ist der Gesamtwert meiner offenen Kaufaufträge für Unternehmen 42?”

Hinweise für Agenten

• Der Parameter company ist erforderlich — Sekundärmarktaufträge sind pro Emittent begrenzt. Wenn sich der Benutzer auf ein Unternehmen nach Ticker oder Name bezieht, rufen Sie zunächst list_tokens auf, um die entsprechende issuerId zu finden, und übergeben Sie diese als company.
• Ein 401 vom Backend bedeutet, dass die Sitzung abgelaufen ist — wechseln Sie zu sign_in und wiederholen Sie den Versuch.
• Ein 404 für ein bestimmtes company bedeutet, dass es nicht existiert; versuchen Sie nicht erneut mit Varianten.