shareholder_registry

Für Emittenten: Lesen Sie die Top-N-Inhaber eines verwalteten Unternehmens aus dem Aktionärsregister, sortiert nach Eigentumsanteil in absteigender Reihenfolge. Gibt Namen, Gesamtzahl der Aktien und Eigentumsanteil in Prozent zurück. Persönliche Kontaktdaten sind absichtlich ausgeschlossen — siehe export_shareholder_registry für die vollständige Datei.

Authentifizierung

Erfordert Anmeldung und Emittentzugriff auf das angeforderte Unternehmen. Rufen Sie zuerst list_managed_companies auf, um eine gültige companyId zu erhalten.

Eingaben

Feld	Typ	Erforderlich	Beschreibung
company	integer	Ja	Unternehmens-ID eines Unternehmens, das der angemeldete Benutzer verwalten darf.
limit	integer	Nein	Wie viele Top-Inhaber zurückgegeben werden sollen. Standard 100, Maximum 1000. Nur erhöhen, wenn der Benutzer dies ausdrücklich anfordert.

Ausgabe

Ein zusammenfassendes Ergebnis mit der Unternehmens-ID, dem angeforderten Limit, einer Anzahl und der Liste der Top-Inhaber:

Feld	Typ	Beschreibung
companyId	integer	Die für die Abfrage verwendete Unternehmens-ID.
count	integer	Anzahl der zurückgegebenen Inhaber (die Top N).
limit	integer	Angefordetes Limit (Standard 100).
holders	array	Top-Inhaber nach Eigentumsanteil, absteigend.

Jede Zeile in holders enthält:

Feld	Typ	Beschreibung
name	string	Name des Inhabers (Einzelperson oder Unternehmen).
total	integer	Gesamtzahl der Aktien aller Aktiengattungen.
ownership	number	Eigentumsanteil in Prozent im Bereich [0, 100], z. B. 3.86 für 3,86%.

E-Mail-Adressen, interne person-IDs, pro Aktiengattung positions[] und ownershipWithoutTreasury werden vom Adapter entfernt und erreichen niemals den Modellkontext.

Beispiel-Eingaben

• “Zeige mir die Top-50-Inhaber meines Unternehmens.”
• “Wer sind die Top-10-Aktionäre von Unternehmen 42?”
• “Wie hoch ist der Eigentumsanteil des größten Aktionärs meines Unternehmens?”

Hinweise für Agenten

• Datenschutz zuerst: Wenn der Benutzer um E-Mails oder Kontaktdaten bittet, versuchen Sie nicht erneut mit erhöhtem Limit — diese Felder werden niemals von diesem Tool zurückgegeben. Verwenden Sie stattdessen export_shareholder_registry, das die vollständigen Daten in eine herunterladbare Datei schreibt, anstatt sie in den Chat zu integrieren.
• Ein 403 bedeutet, dass der angemeldete Benutzer keinen Emittentzugriff für das angegebene company hat. Führen Sie list_managed_companies erneut aus und versuchen Sie es mit einer gültigen ID.
• Ein 404 bedeutet, dass das Unternehmen nicht existiert. Führen Sie list_managed_companies erneut aus und versuchen Sie es mit einer gültigen ID.
• Ein 401 bedeutet, dass die Sitzung abgelaufen ist. Rufen Sie sign_in auf und versuchen Sie es erneut.