shareholder_registry

Per gli emittenti: leggi i primi N detentori del registro azionisti di una società gestita, ordinati per proprietà in ordine decrescente. Restituisce il nome, le azioni totali possedute e la proprietà in percentuale. I dettagli di contatto personali sono intenzionalmente esclusi — vedi export_shareholder_registry per il file completo.

Autenticazione

Richiede l’accesso e l’accesso da emittente alla società richiesta. Chiama prima list_managed_companies per ottenere un companyId valido.

Input

Campo	Tipo	Obbligatorio	Descrizione
company	integer	Sì	ID della società di una società che l’utente connesso è autorizzato a gestire.
limit	integer	No	Quanti detentori principali restituire. Predefinito 100, massimo 1000. Aumenta solo se l’utente lo chiede esplicitamente.

Output

Un involucro di riepilogo con l’id della società, il limite richiesto, un conteggio e l’elenco dei principali detentori:

Campo	Tipo	Descrizione
companyId	integer	L’id della società utilizzato per la ricerca.
count	integer	Numero di detentori restituiti (i primi N).
limit	integer	Limite richiesto (predefinito 100).
holders	array	Principali detentori per proprietà, in ordine decrescente.

Ogni riga in holders contiene:

Campo	Tipo	Descrizione
name	string	Nome del detentore (individuo o entità).
total	integer	Azioni totali possedute in tutte le classi di azioni.
ownership	number	Proprietà come percentuale in [0, 100], ad es. 3.86 per il 3,86%.

Gli indirizzi email, gli id interni di person, le positions[] per classe di azioni e ownershipWithoutTreasury sono rimossi dall’adattatore e non raggiungono mai il contesto del modello.

Prompt di Esempio

• “Mostrami i primi 50 detentori della mia società.”
• “Chi sono i 10 principali azionisti della società 42?”
• “Qual è la percentuale di proprietà del maggiore azionista della mia società?”

Note per gli Agenti

• Privacy in primo luogo: se l’utente chiede email o dettagli di contatto, non riprovare con limiti aumentati — questi campi non vengono mai restituiti da questo strumento. Utilizza invece export_shareholder_registry, che scrive i dati completi in un file scaricabile piuttosto che nella chat.
• Un 403 significa che l’utente connesso non ha accesso da emittente per la company data. Esegui di nuovo list_managed_companies e riprova con un id valido.
• Un 404 significa che la società non esiste. Esegui di nuovo list_managed_companies e riprova con un id valido.
• Un 401 significa che la sessione è scaduta. Chiama sign_in e riprova.