Skip to main content

ListOrders

Returns working and recent orders for an account or set of accounts. Use this and ListPositions together before any write action that could affect order state.

PropertyValue
Required scopemcp:read
RiskNone. Read-only.
Side effectsNone.

When an agent should use it​

  • Before Cancel* or CancelAndBracket.
  • Before Flatten* if working orders should be considered.
  • In a pre-session audit.
  • After a position change to verify protective brackets are in place.

When an agent should not use it​

  • As a substitute for order status. Use GetOrderStatus or GetOrder for one id.

Parameters​

{ "account": "Sim101" }

GetAllOrders returns across accounts.

Response shape​

{
  "orders": [
    {
      "order_id": "abc-123",
      "account": "Sim101",
      "instrument": "MES 06-26",
      "side": "Buy",
      "type": "Limit",
      "quantity": 1,
      "limit_price": 5235.00,
      "status": "Working"
    }
  ]
}

Example user prompt​

List working orders on Sim101. Group by instrument. Flag any that look orphaned
relative to current positions. Do not cancel anything.

Example tool call​

{ "name": "ListOrders", "arguments": { "account": "Sim101" } }

Common errors​

SymptomLikely causeFix
Empty resultNo working orders.Confirm with GetAccountSummary.
Stale statusSubscription delay.Re-call after a few seconds.

Safe workflow placement​

The agent should list orders before any Cancel* and again after, to confirm only the intended IDs were cancelled.