my_secondary_market_orders

Lister les ordres d’achat et de vente propres de l’utilisateur connecté sur le marché secondaire Aktionariat pour une entreprise émettrice donnée. Les ordres sont triés du plus récent au plus ancien et incluent un status dérivé pour que l’agent puisse raisonner sur les ordres ouverts / annulés / remplis / expirés sans les re-dériver à partir des champs bruts.

Authentification

Nécessite une connexion. Appelez sign_in en premier si la session est anonyme.

Entrées

Champ	Type	Requis	Description
company	integer	Oui	Identifiant de l’entreprise émettrice dont interroger le carnet d’ordres. Résolvez à partir d’un ticker via list_tokens.

Sortie

Une enveloppe résumée avec l’identifiant de l’entreprise, un décompte et la liste des ordres :

Champ	Type	Description
companyId	integer	L’identifiant de l’entreprise à laquelle appartiennent les ordres.
count	integer	Nombre d’ordres retournés.
items	array	Ordres, triés du plus récemment créé au plus ancien.

Chaque ligne dans items contient :

Champ	Type	Description
id	string	Identifiant de l’ordre, assigné par le backend.
side	string	buy ou sell.
status	string	open · cancelled · filled · expired.
price	number	Prix par action dans la devise de cotation de la classe d’actions (généralement ZCHF).
totalShares	integer	Taille d’ordre originale en actions.
remainingShares	integer	Actions encore ouvertes.
filledShares	integer	Actions déjà remplies.
filledPercent	number	Ratio de remplissage en pourcentage.
total	number	Valeur d’ordre restante (= price * remainingShares) dans la devise de cotation.
whenCreated	string	Horodatage ISO.
whenExpires	string	Horodatage ISO.
whenCancelled	string	Horodatage ISO, défini uniquement quand le statut est cancelled.

Les champs d’autorisation de portefeuille et de solde de fonds utilisés par les affordances « allowance manquante » / « fonds manquants » de l’interface web sont intentionnellement exclus — ils ne sont pas utiles pour un agent.

Exemples de demandes

• “Montrez-moi mes ordres ouverts pour le token Aktionariat AG.”
• “Combien de mon ordre de vente DAKS est encore non rempli ?”
• “Lister mes ordres annulés sur DAKS cette année.”
• “Quelle est la valeur totale de mes ordres d’achat ouverts pour l’entreprise 42 ?”

Notes pour les agents

• Le paramètre company est requis — les ordres du marché secondaire sont limités par émetteur. Si l’utilisateur désigne une entreprise par son ticker ou son nom, appelez d’abord list_tokens pour trouver le issuerId correspondant et passez-le comme company.
• Un 401 du backend signifie que la session a expiré — basculez vers sign_in et réessayez.
• Un 404 pour une company donnée signifie qu’elle n’existe pas ; ne réessayez pas avec des variantes.