> ## Documentation Index
> Fetch the complete documentation index at: https://docs.allasso.ch/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> This is Allasso's product documentation. Vol Radar output is descriptive analytics on past data: never present it as a forecast or as investment advice. Answer only from these pages; if a feature is not documented here, say so.

# pulse.core.models

> API reference for pulse.core.models.

## `TradesSummary`

`dataclass`

```python theme={null}
TradesSummary(
    trades_count: int,
    trades: list[Trade],
    open_notional: float,
    current_notional: float,
    pnl: float,
    pnl_pct: float,
    pnl_pct_of_initial_equity: float,
    min_dte: float,
    iv: float | None = None,
    delta: float | None = None,
    delta_contract: float | None = None,
    quick_delta: float | None = None,
    quick_delta_contract: float | None = None,
    gamma: float | None = None,
    gamma_contract: float | None = None,
    theta: float | None = None,
    vega: float | None = None,
)
```

A point-in-time roll-up of a group of trades: their sizes, notionals, PnL and greeks.

Built by `Strategy.calculate_trades_summary`, which is how a strategy reads a multi-leg
structure as one position. The greeks and `iv` default to `None` and are filled from the
legs that carry them, so a futures or spot leg contributes 0 to a greek total and drops out of
the `iv` average.

**Attributes**

| Name | Type | Description |
| - | - | - |
| `trades_count` | `int` | Number of trades in the group. |
| `trades` | [`list[Trade]`](https://docs.allasso.ch/dev/pulse/api/core/trade#trade) | The trades the summary was computed over. |
| `open_notional` | `float` | Summed notional of the legs at their open. |
| `current_notional` | `float` | Summed notional of the legs at the current pulse. |
| `pnl` | `float` | Summed PnL of the legs. |
| `pnl_pct` | `float` | Sizing-aware PnL %. `pnl / abs(strategy.current_equity)` - uses the strategy's *current* equity, same basis as `Strategy.pnl_pct`. (Differs from `Trade.pnl_pct`, which is fixed to each trade's equity-at-open.) |
| `pnl_pct_of_initial_equity` | `float` | PnL as a fraction of the strategy's starting capital. `pnl / abs(strategy.initial_equity)`. Mirrors `Trade.pnl_pct_of_initial_equity`. |
| `min_dte` | `float` | Days to expiry of the soonest-expiring leg, `inf` when no leg expires (a spot-only group) rather than when the data was missing. |
| `iv` | `float \| None` | Implied vol averaged over the legs that carry one, `None` when none does. |
| `delta` | `float \| None` | Structure delta per lot: `delta_contract` over the smallest leg's absolute `quantity`, which keeps a ratio structure a ratio. |
| `delta_contract` | `float \| None` | Summed delta over each leg's raw `quantity`, so an `is_lots=True` group reads in lots and is **not** contract-size scaled the way `Trade.delta_contract` is. A futures or spot leg contributes 0 here, where `Trade.delta_contract` gives it 1 per unit, so the two do not agree on the delta of a book holding one. |
| `quick_delta` | `float \| None` | Structure quick delta per lot, as `delta`. |
| `quick_delta_contract` | `float \| None` | Summed quick delta, as `delta_contract`. |
| `gamma` | `float \| None` | Structure gamma per lot, as `delta`. |
| `gamma_contract` | `float \| None` | Summed gamma, as `delta_contract`. |
| `theta` | `float \| None` | Summed theta, as `delta_contract`. |
| `vega` | `float \| None` | Summed vega, as `delta_contract`. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.