my_secondary_market_orders

List the signed-in user’s own buy and sell orders on the Aktionariat secondary market for a given issuing company. Orders are sorted most-recent first and include a derived status so the agent can reason about open / cancelled / filled / expired without re-deriving it from raw fields.

Authentication

Requires sign-in. Call sign_in first if the session is anonymous.

Inputs

Field	Type	Required	Description
company	integer	Yes	Issuer company id whose order book to query. Resolve from a ticker via list_tokens.

Output

A summary envelope with the company id, a count, and the list of orders:

Field	Type	Description
companyId	integer	The company id the orders belong to.
count	integer	Number of orders returned.
items	array	Orders, sorted most-recently-created first.

Each row in items contains:

Field	Type	Description
id	string	Order id, as assigned by the backend.
side	string	buy or sell.
status	string	open · cancelled · filled · expired.
price	number	Price per share in the share class’s quote currency (typically ZCHF).
totalShares	integer	Original order size in shares.
remainingShares	integer	Shares still open.
filledShares	integer	Shares already filled.
filledPercent	number	Fill ratio as a percentage.
total	number	Remaining order value (= price * remainingShares) in the quote currency.
whenCreated	string	ISO timestamp.
whenExpires	string	ISO timestamp.
whenCancelled	string	ISO timestamp, set only when status is cancelled.

Wallet allowance and funds-balance fields used by the web UI’s “missing allowance” / “missing funds” affordances are intentionally excluded — they are not useful for an agent.

Example Prompts

• “Show me my open orders for the Aktionariat AG token.”
• “How much of my DAKS sell order is still unfilled?”
• “List my cancelled orders on DAKS this year.”
• “What is the total value of my open buy orders for company 42?”

Notes for Agents

• The company parameter is required — secondary-market orders are scoped per issuer. If the user refers to a company by ticker or name, call list_tokens first to find the matching issuerId and pass that as company.
• A 401 from the backend means the session expired — fall back to sign_in and retry.
• A 404 for a given company means it does not exist; do not retry with variants.