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

# Structures

> A structure is a multi-leg option position - a spread, a strangle, a condor.

The `structures` module (`from pulse import structures`) provides premade resolvers that turn one call into a bundle of ready-to-trade legs, so you skip resolving each expiry and strike by hand.

## What a structure resolver returns

Each `*_by_delta` function takes the `resolver`, an underlying, a timestamp, the per-leg deltas and a
`min_dte`, and returns a `NamedTuple` with one attribute per leg. You then place an order per leg:

```python theme={null}
from pulse import structures

legs = structures.strangle_by_delta(
    self.resolver, self.underlying_id[0], self.last_pulse,
    call_delta=0.20, put_delta=0.20, min_dte=30,
)
self.broker.create_order(self.pulse_index, legs.put,  -size, is_lots=True)
self.broker.create_order(self.pulse_index, legs.call, -size, is_lots=True)
```

The legs are addressed by name (`legs.put`, `legs.call`) or position. The resolver picks the strikes;
the **quantities and direction stay in your strategy** - a structure resolver never decides how much to
buy or sell, so the same `strangle_by_delta` serves both a long and a short strangle.

> [!NOTE]
>
> **Strikes match the manual path exactly**
>
> A structure resolver is a thin wrapper over the [strike and expiry resolvers](https://docs.allasso.ch/dev/pulse/concepts/resolvers.md): it
> resolves the expiry once, then each leg's strike by delta (placing equidistant legs via the
> absolute resolver where the shape requires it). Resolving the legs yourself gives the same strikes.

## The families

| Family | Resolvers | Reach for it when |
| - | - | - |
| Single-leg | `option_by_delta` | one call or put at a delta. |
| Verticals | `spread_by_delta` | two same-type legs: a debit or credit spread. |
| Straddle / strangle | `straddle_by_delta`, `strangle_by_delta` | long or short volatility at one or two strikes. |
| Butterflies | `butterfly_by_delta`, `broken_wing_butterfly_by_delta` | a pinned body with two wings; equidistant or skewed. |
| Ladders | `ladder_by_delta`, `broken_ladder_by_delta` | three same-type strikes stacked one way. |
| Condors | `condor_by_delta`, `broken_condor_by_delta` | four same-type strikes; equidistant or skewed. |
| Iron condors / butterflies | `iron_condor_by_delta`, `broken_iron_condor_by_delta`, `iron_butterfly_by_delta`, `broken_iron_butterfly_by_delta` | put spread plus call spread around the body. |
| Jade lizard | `jade_lizard_by_delta` | short put plus a short call spread. |
| Calendar / diagonal | `calendar_spread_by_delta`, `diagonal_spread_by_delta` | same strike (calendar) or stepped strike (diagonal) across two expiries. |
| Exotics | `albatross_by_delta`, `pterodactyl_by_delta`, `iron_albatross_by_delta`, `iron_pterodactyl_by_delta` | wider four-strike wing shapes. |

The named tuples are shared across families - `butterfly_by_delta` and its broken-wing variant both
return a `Butterfly`; the condor shapes return a `Condor`; the iron variants return an `IronCondor` or
`IronButterfly`.

## Which structure when

| You want | Structure |
| - | - |
| directional, single strike | single-leg |
| directional, capped risk | vertical |
| long or short volatility | straddle / strangle |
| a pinned target with defined risk | butterfly / iron butterfly |
| range-bound, defined risk | condor / iron condor |
| skewed payoff, one extra leg | jade lizard, broken-wing variants |
| a view on the term structure | calendar / diagonal |

## Building structures

This page is the conceptual map. For copy-paste recipes - both the **Manual** path (resolve each leg
yourself) and the **Helper** path (a structures resolver) - see the
[Structures section](https://docs.allasso.ch/dev/pulse/structures/index.md), which has runnable code per family. The full resolver
list, including the exotic variants, is in the \[`structures` API reference]\[pulse.structures].

**Related:** [Resolvers](https://docs.allasso.ch/dev/pulse/concepts/resolvers.md) · [DataFeed and market data](https://docs.allasso.ch/dev/pulse/concepts/datafeed.md) ·
[Architecture and the pulse loop](https://docs.allasso.ch/dev/pulse/concepts/architecture.md)


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