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

# Verticals

> Two same-expiry options of the same type at different strikes - a defined-risk directional play.

The snippets assume the [shared scaffold](https://docs.allasso.ch/dev/pulse/structures/index.md) (`u = self.underlying_id[0]`, a computed `size`, and `from pulse import structures, InstrumentType, Option, PeriodType, PeriodID`).

> [!TIP]
>
> **Reading the deltas**
>
> A higher-delta option is **closer to the money** (lower strike for calls, higher strike for puts).
> `spread_by_delta(long_delta=…, short_delta=…)` **buys** the `long_delta` leg and **sells** the
> `short_delta` leg - the deltas decide which strike is long vs short.

## Bull call spread

Buy a call, sell a higher call to cheapen it - a bullish **debit** play.

* **Max profit** - (short strike - long strike) - net debit.
* **Max loss** - the net debit paid. **Bias** - bullish, defined risk.

> [tab] Manual
>
> ```python theme={null}
> expiry = self.resolver.expiry.relative(
>     underlying_id=u, as_of_time=self.last_pulse, period_type=PeriodType.MONTH,
>     instrument_type=CALL, nth=1, period_id=PeriodID.ALL, min_dte=self._min_dte,
> )[0]
> buy_strike  = self.resolver.strike.delta.resolve(   # 40Δ - nearer the money, lower strike
>     underlying_id=u, as_of_time=self.last_pulse, expiration_date=expiry,
>     instrument_type=CALL, strike_value=0.40)
> sell_strike = self.resolver.strike.delta.resolve(   # 20Δ - further OTM, higher strike
>     underlying_id=u, as_of_time=self.last_pulse, expiration_date=expiry,
>     instrument_type=CALL, strike_value=0.20)
> buy_call  = Option(u, CALL, buy_strike,  expiry)
> sell_call = Option(u, CALL, sell_strike, expiry)
> size = self._size(buy_call)
> self.broker.create_order(self.pulse_index, buy_call,  +size, is_lots=True)
> self.broker.create_order(self.pulse_index, sell_call, -size, is_lots=True)
> ```

> [tab] Helper
>
> ```python theme={null}
> legs = structures.spread_by_delta(
>     self.resolver, u, self.last_pulse,
>     instrument_type=CALL, long_delta=0.40, short_delta=0.20, min_dte=self._min_dte,
> )
> size = self._size(legs.long_option)
> self.broker.create_order(self.pulse_index, legs.long_option,  +size, is_lots=True)  # buy 40Δ
> self.broker.create_order(self.pulse_index, legs.short_option, -size, is_lots=True)  # sell 20Δ
> ```

## Bear call spread

Sell a call, buy a higher call for protection - a bearish/neutral **credit** play.

* **Max profit** - the net credit. **Max loss** - (long strike - short strike) - credit. **Bias** - bearish, defined risk.

> [tab] Manual
>
> ```python theme={null}
> expiry = self.resolver.expiry.relative(
>     underlying_id=u, as_of_time=self.last_pulse, period_type=PeriodType.MONTH,
>     instrument_type=CALL, nth=1, period_id=PeriodID.ALL, min_dte=self._min_dte,
> )[0]
> sell_strike = self.resolver.strike.delta.resolve(   # 40Δ - sell nearer the money
>     underlying_id=u, as_of_time=self.last_pulse, expiration_date=expiry,
>     instrument_type=CALL, strike_value=0.40)
> buy_strike  = self.resolver.strike.delta.resolve(   # 20Δ - buy the wing
>     underlying_id=u, as_of_time=self.last_pulse, expiration_date=expiry,
>     instrument_type=CALL, strike_value=0.20)
> sell_call = Option(u, CALL, sell_strike, expiry)
> buy_call  = Option(u, CALL, buy_strike,  expiry)
> size = self._size(sell_call)
> self.broker.create_order(self.pulse_index, sell_call, -size, is_lots=True)
> self.broker.create_order(self.pulse_index, buy_call,  +size, is_lots=True)
> ```

> [tab] Helper
>
> ```python theme={null}
> legs = structures.spread_by_delta(
>     self.resolver, u, self.last_pulse,
>     instrument_type=CALL, long_delta=0.20, short_delta=0.40, min_dte=self._min_dte,
> )
> size = self._size(legs.short_option)
> self.broker.create_order(self.pulse_index, legs.short_option, -size, is_lots=True)  # sell 40Δ
> self.broker.create_order(self.pulse_index, legs.long_option,  +size, is_lots=True)  # buy 20Δ
> ```

## Bull put spread

Sell a put, buy a lower put to cap the risk - a bullish/neutral **credit** play.

* **Max profit** - the net credit. **Max loss** - (short strike - long strike) - credit. **Bias** - bullish, defined risk.

> [tab] Manual
>
> ```python theme={null}
> expiry = self.resolver.expiry.relative(
>     underlying_id=u, as_of_time=self.last_pulse, period_type=PeriodType.MONTH,
>     instrument_type=PUT, nth=1, period_id=PeriodID.ALL, min_dte=self._min_dte,
> )[0]
> sell_strike = self.resolver.strike.delta.resolve(   # 40Δ - sell nearer the money
>     underlying_id=u, as_of_time=self.last_pulse, expiration_date=expiry,
>     instrument_type=PUT, strike_value=0.40)
> buy_strike  = self.resolver.strike.delta.resolve(   # 20Δ - buy the lower wing
>     underlying_id=u, as_of_time=self.last_pulse, expiration_date=expiry,
>     instrument_type=PUT, strike_value=0.20)
> sell_put = Option(u, PUT, sell_strike, expiry)
> buy_put  = Option(u, PUT, buy_strike,  expiry)
> size = self._size(sell_put)
> self.broker.create_order(self.pulse_index, sell_put, -size, is_lots=True)
> self.broker.create_order(self.pulse_index, buy_put,  +size, is_lots=True)
> ```

> [tab] Helper
>
> ```python theme={null}
> legs = structures.spread_by_delta(
>     self.resolver, u, self.last_pulse,
>     instrument_type=PUT, long_delta=0.20, short_delta=0.40, min_dte=self._min_dte,
> )
> size = self._size(legs.short_option)
> self.broker.create_order(self.pulse_index, legs.short_option, -size, is_lots=True)  # sell 40Δ
> self.broker.create_order(self.pulse_index, legs.long_option,  +size, is_lots=True)  # buy 20Δ
> ```

## Bear put spread

Buy a put, sell a lower put to cheapen it - a bearish **debit** play.

* **Max profit** - (long strike - short strike) - net debit. **Max loss** - the net debit. **Bias** - bearish, defined risk.

> [tab] Manual
>
> ```python theme={null}
> expiry = self.resolver.expiry.relative(
>     underlying_id=u, as_of_time=self.last_pulse, period_type=PeriodType.MONTH,
>     instrument_type=PUT, nth=1, period_id=PeriodID.ALL, min_dte=self._min_dte,
> )[0]
> buy_strike  = self.resolver.strike.delta.resolve(   # 40Δ - buy nearer the money
>     underlying_id=u, as_of_time=self.last_pulse, expiration_date=expiry,
>     instrument_type=PUT, strike_value=0.40)
> sell_strike = self.resolver.strike.delta.resolve(   # 20Δ - sell the lower wing
>     underlying_id=u, as_of_time=self.last_pulse, expiration_date=expiry,
>     instrument_type=PUT, strike_value=0.20)
> buy_put  = Option(u, PUT, buy_strike,  expiry)
> sell_put = Option(u, PUT, sell_strike, expiry)
> size = self._size(buy_put)
> self.broker.create_order(self.pulse_index, buy_put,  +size, is_lots=True)
> self.broker.create_order(self.pulse_index, sell_put, -size, is_lots=True)
> ```

> [tab] Helper
>
> ```python theme={null}
> legs = structures.spread_by_delta(
>     self.resolver, u, self.last_pulse,
>     instrument_type=PUT, long_delta=0.40, short_delta=0.20, min_dte=self._min_dte,
> )
> size = self._size(legs.long_option)
> self.broker.create_order(self.pulse_index, legs.long_option,  +size, is_lots=True)  # buy 40Δ
> self.broker.create_order(self.pulse_index, legs.short_option, -size, is_lots=True)  # sell 20Δ
> ```

> [!NOTE]
>
> **Signal-driven verticals**
>
> To flip between bull-put and bear-call spreads from an external signal series, see the
> [Vertical Spreads with Signals](https://docs.allasso.ch/dev/pulse/notebooks/vertical-spreads.md) notebook.


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