> ## 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.aggregate

> API reference for pulse.core.aggregate.

## `aggregate_per_pulse_to_daily`

```python theme={null}
aggregate_per_pulse_to_daily(
    values: list[float],
    datetimes: list[datetime],
    op: Literal['sum', 'compound', 'last'] = 'sum',
) -> tuple[list[date], list[float], list[datetime]]
```

Group per-pulse values by date and collapse each group.

**Parameters**

| Name | Type | Description | Default |
| - | - | - | - |
| `values` | `list[float]` | Per-pulse values aligned to `datetimes`. | *required* |
| `datetimes` | `list[datetime]` | Per-pulse timestamps. | *required* |
| `op` | `Literal['sum', 'compound', 'last']` | "sum" for additive (abs P\&L); "compound" for multiplicative pct returns (prod(1+r)-1); "last" for level series (e.g. equity end-of-day). | `'sum'` |

**Returns**

| Type | Description |
| - | - |
| `tuple[list[date], list[float], list[datetime]]` | tuple\[list\[date], list\[float], list\[datetime]]: (unique dates, aggregated values, last per-pulse datetime per date) in chronological order. |

## `trades_to_dataframe`

```python theme={null}
trades_to_dataframe(trades: Iterable[Trade]) -> pd.DataFrame
```

One row per trade, the serialized trade fields as columns.

**Parameters**

| Name | Type | Description | Default |
| - | - | - | - |
| `trades` | [`Iterable[Trade]`](https://docs.allasso.ch/dev/pulse/api/core/trade#trade) | The trades to tabulate; a `pandas.Series` of trades works too. | *required* |

**Returns**

| Type | Description |
| - | - |
| `DataFrame` | pd.DataFrame: The `TradeDictSerializer.serialize` fields as columns, plus two object columns carrying the originals: `trade_object` (the `Trade`) and `trade_serialized` (its dict). |

## `aggregate_trades`

```python theme={null}
aggregate_trades(
    trades: list[Trade],
    filter_tags: list[str] | None = None,
    match_all_tags: bool = True,
    group_by: str = 'open_datetime',
    explode: bool = False,
) -> pd.DataFrame
```

Roll a flat list of trades up into one row per multi-leg structure.

Legs are grouped by `group_by` (trades opened on the same pulse are one structure by
default), quantities and notionals are summed, and the leg prices are combined into a single
structure price per unit: each price is weighted by its signed leg quantity, summed, then
divided by the smallest absolute leg quantity, so a ratio spread keeps its ratio. Only the
absolute PnL and notional histories are summed element-wise into group-level histories: the
price and percentage histories are recombined as ratios and `datetimes` is the union of the
legs'. The `daily_*` columns collapse those to one value per calendar date (summed for
absolute PnL, compounded for percentages).

The `pnl_pct` column is against the structure's own open notional, not against equity, so it
is not the same basis as `TradesSummary.pnl_pct`.

**Parameters**

| Name | Type | Description | Default |
| - | - | - | - |
| `trades` | [`list[Trade]`](https://docs.allasso.ch/dev/pulse/api/core/trade#trade) | The trades to aggregate. | *required* |
| `filter_tags` | `list[str] \| None` | Keep only trades carrying these tags; `None` keeps all. | `None` |
| `match_all_tags` | `bool` | With `filter_tags`, require every tag rather than any one of them. | `True` |
| `group_by` | `str` | Serialized trade field the legs are grouped on. The grouping column is named `open_datetime` in the output whatever field it was. | `'open_datetime'` |
| `explode` | `bool` | Explode the per-pulse history columns into one row per pulse. The `daily_*` columns are a different length and stay nested either way. | `False` |

**Returns**

| Type | Description |
| - | - |
| `DataFrame` | pd.DataFrame: One row per group, or one row per pulse per group when `explode`. An empty `trades` gives back the empty per-trade frame unchanged. |


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