shareholder_registry

Pour les émetteurs : lire les N principaux détenteurs du registre des actionnaires d’une entreprise gérée, triés par propriété décroissante. Retourne le nom, le nombre total d’actions détenues et la propriété en pourcentage. Les coordonnées personnelles sont intentionnellement exclues — voir export_shareholder_registry pour le fichier complet.

Authentification

Nécessite une connexion et un accès émetteur à l’entreprise demandée. Appelez list_managed_companies en premier pour obtenir un companyId valide.

Entrées

Champ	Type	Obligatoire	Description
company	integer	Oui	Id de l’entreprise que l’utilisateur connecté est autorisé à gérer.
limit	integer	Non	Combien de principaux détenteurs à retourner. Par défaut 100, maximum 1000. N’augmentez que si l’utilisateur le demande explicitement.

Sortie

Une enveloppe récapitulative avec l’id de l’entreprise, la limite demandée, un décompte et la liste des principaux détenteurs :

Champ	Type	Description
companyId	integer	L’id de l’entreprise utilisé pour la recherche.
count	integer	Nombre de détenteurs retournés (les N premiers).
limit	integer	Limite demandée (par défaut 100).
holders	array	Principaux détenteurs par propriété, décroissant.

Chaque ligne dans holders contient :

Champ	Type	Description
name	string	Nom du détenteur (personne physique ou morale).
total	integer	Nombre total d’actions détenues dans toutes les catégories d’actions.
ownership	number	Propriété en pourcentage dans [0, 100], ex. 3.86 pour 3.86%.

Les adresses e-mail, les ids person internes, les positions[] par catégorie d’actions et ownershipWithoutTreasury sont supprimés par l’adaptateur et n’atteignent jamais le contexte du modèle.

Exemples de requêtes

• « Montrez-moi les 50 principaux détenteurs de mon entreprise. »
• « Qui sont les 10 principaux actionnaires de l’entreprise 42? »
• « Quel est le pourcentage de propriété du plus grand actionnaire de mon entreprise? »

Notes pour les agents

• Confidentialité d’abord : si l’utilisateur demande des e-mails ou des coordonnées, ne réessayez pas avec des limites augmentées — ces champs ne sont jamais retournés par cet outil. Utilisez export_shareholder_registry à la place, qui écrit les données complètes dans un fichier téléchargeable plutôt que dans le chat.
• Un 403 signifie que l’utilisateur connecté n’a pas accès émetteur pour l’company donnée. Réexécutez list_managed_companies et réessayez avec un id valide.
• Un 404 signifie que l’entreprise n’existe pas. Réexécutez list_managed_companies et réessayez avec un id valide.
• Un 401 signifie que la session a expiré. Appelez sign_in et réessayez.