`get_orders`

List the user's orders and their state-change events, newest first.

Scope: ladder:read

Input

Name	Type	Required	Description
`since`	`string (date-time)`	Optional	Only return orders created or updated after this RFC 3339 time.

JSON Schema

input_schema

{
  "type": "object",
  "properties": {
    "since": {
      "type": "string",
      "format": "date-time",
      "description": "Only return orders created or updated after this RFC 3339 time."
    }
  },
  "additionalProperties": false
}

Example

Request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_orders",
    "arguments": {
      "since": "2026-10-16T00:00:00Z"
    }
  }
}

Result

{
  "orders": [
    {
      "id": "0b6f3c2e-6a8f-4f7e-9d0e-2a51c4b7e913",
      "state": "filled",
      "intent": {
        "symbol": "SPY",
        "expiry": "2026-10-23",
        "strike": 582,
        "side": "above",
        "width": 1,
        "qty": 2,
        "limit": 0.52
      },
      "net_price": 0.52,
      "paper": true,
      "events": [
        {
          "order_id": "0b6f3c2e-6a8f-4f7e-9d0e-2a51c4b7e913",
          "state": "pending",
          "at": "2026-10-16T19:21:04Z"
        },
        {
          "order_id": "0b6f3c2e-6a8f-4f7e-9d0e-2a51c4b7e913",
          "state": "open",
          "at": "2026-10-16T19:21:04Z"
        },
        {
          "order_id": "0b6f3c2e-6a8f-4f7e-9d0e-2a51c4b7e913",
          "state": "filled",
          "at": "2026-10-16T19:21:31Z"
        }
      ]
    }
  ]
}

Abbreviated; each entry is the full Order shape plus its events.