`get_positions`

List the user's open spreads with entry, mark and P&L. Each position sits on its lower-strike rung with a signed quantity.

Scope: ladder:read

Input

Name	Type	Required	Description
`symbol`	`string`	Optional	Only return positions on this underlying.pattern ^[A-Z]{1,6}$

JSON Schema

input_schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string",
      "pattern": "^[A-Z]{1,6}$",
      "description": "Only return positions on this underlying."
    }
  },
  "additionalProperties": false
}

Example

Request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_positions",
    "arguments": {
      "symbol": "SPY"
    }
  }
}

Result

{
  "positions": [
    {
      "id": "pos_spy_20261023_582_583_above",
      "symbol": "SPY",
      "expiry": "2026-10-23",
      "side": "above",
      "lower_strike": 582,
      "upper_strike": 583,
      "width": 1,
      "qty": 2,
      "entry_price": 0.52,
      "mark": 0.53,
      "pnl": 2,
      "paper": true
    }
  ]
}