my_secondary_market_orders

Elencare i propri ordini di acquisto e vendita dell’utente connesso sul mercato secondario Aktionariat per una determinata società emittente. Gli ordini sono ordinati dal più recente al meno recente e includono uno status derivato in modo che l’agente possa ragionare su ordini aperti / annullati / eseguiti / scaduti senza doverli derivare nuovamente dai campi grezzi.

Autenticazione

Richiede accesso. Chiamare sign_in prima se la sessione è anonima.

Input

Campo	Tipo	Obbligatorio	Descrizione
company	integer	Sì	ID della società emittente il cui order book si desidera interrogare. Risolvere da un ticker tramite list_tokens.

Output

Un’inviluppo di riepilogo con l’ID della società, un conteggio e l’elenco degli ordini:

Campo	Tipo	Descrizione
companyId	integer	L’ID della società a cui appartengono gli ordini.
count	integer	Numero di ordini restituiti.
items	array	Ordini, ordinati dal più recente al meno recente.

Ogni riga in items contiene:

Campo	Tipo	Descrizione
id	string	ID ordine, assegnato dal backend.
side	string	buy o sell.
status	string	open · cancelled · filled · expired.
price	number	Prezzo per azione nella valuta di quotazione della classe di azioni (generalmente ZCHF).
totalShares	integer	Dimensione ordine originale in azioni.
remainingShares	integer	Azioni ancora aperte.
filledShares	integer	Azioni già eseguite.
filledPercent	number	Rapporto di esecuzione in percentuale.
total	number	Valore ordine rimanente (= price * remainingShares) nella valuta di quotazione.
whenCreated	string	Timestamp ISO.
whenExpires	string	Timestamp ISO.
whenCancelled	string	Timestamp ISO, impostato solo quando lo stato è cancelled.

I campi di saldo consentito e saldo fondi utilizzati dagli strumenti dell’interfaccia web “manca consentimento” / “mancano fondi” sono intenzionalmente esclusi — non sono utili per un agente.

Esempio di Prompt

• “Mostrami i miei ordini aperti per il token Aktionariat AG.”
• “Quanto del mio ordine di vendita DAKS è ancora non eseguito?”
• “Elencare i miei ordini annullati su DAKS quest’anno.”
• “Qual è il valore totale dei miei ordini di acquisto aperti per la società 42?”

Note per gli Agenti

• Il parametro company è obbligatorio — gli ordini del mercato secondario hanno portata per emittente. Se l’utente fa riferimento a una società per ticker o nome, chiamare prima list_tokens per trovare l’issuerId corrispondente e passarlo come company.
• Un 401 dal backend significa che la sessione è scaduta — ricorrere a sign_in e riprovare.
• Un 404 per una determinata company significa che non esiste; non riprovare con varianti.