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

# Surface report

> Read a market's implied volatility at seven forward deltas by listed contract, rank or period, compare it with an earlier date or its own history, and open the smile and history of any cell.

The **Surface** page shows one market's implied volatility on one day as a grid: seven forward deltas down the side
(10P, 25P, 40P, ATM, 40C, 25C, 10C) and listed contracts, ranks or periods across the top. Each cell also shows a
second number: the change since a comparison date, or where today's vol sits in its own history. Click a cell to open
the smile of its column and the history of that cell.

## When to use it

* You want the whole surface on one screen, with what moved since last week or last month.
* You want to know if a part of the curve or the smile is high or low against its own history.
* You trade periods (quarters, seasons, half-years, years) and want their vol as an option strip.

## Before you start

The page covers the markets with options analytics. The **Columns** choices depend on the market:

| Market | Universe | Options analytics | Surface report columns | History from |
| - | - | - | - | - |
| TTF gas | Energy & Environmental | Yes | contracts, relative, quarters, seasons, half-years, years | 2015 |
| Henry Hub gas | Energy & Environmental | Yes | contracts, relative, quarters, seasons, half-years, years | 2007 |
| Brent crude | Energy & Environmental | Yes | contracts, relative, quarters, half-years, years | 2007 |
| WTI crude | Energy & Environmental | Yes | contracts, relative, quarters, half-years, years | 2005 |
| ICE gasoil | Energy & Environmental | Yes | contracts, relative, quarters, half-years, years | 2015 |
| NY Harbor ULSD | Energy & Environmental | Yes | contracts, relative, quarters, half-years, years | 2005 |
| EUA carbon | Energy & Environmental | Yes | contracts, relative | 2008 |

## Steps

**1. Pick the market and day**

Choose **Market** and **Date**. If the date has no data, the page shows the nearest earlier day and says
"No data on … — showing …".

**2. Choose the columns**

Under **Columns**, pick **Contracts**, **Relative (M1…)** or a period type. **Show** sets how many columns you see.

**3. Set the comparison**

Pick a **Compare with** preset, or type a day in **or a date**. Then choose **Show in cells**: **IV change**,
**Percentile** or **Z-score**.

**4. Click a cell**

The smile panel, the Vol Context panel and the cell history open below the grid for that column and delta.

![Surface report grid for Brent crude on 13 Jul 2026](https://mintcdn.com/allasso/wGLYpJ2DpEuY5p8A/images/vol-radar/surface-report.png?fit=max\&auto=format\&n=wGLYpJ2DpEuY5p8A\&q=85\&s=0504159781231dce5a297e6e89b5a62e)

Brent crude, 13 Jul 2026: contracts view, change against 12 Jun 2026

## Settings

| Control | Options | Default | Effect | URL parameter |
| - | - | - | - | - |
| Market | Markets with options analytics | Brent crude | Market shown | `m` |
| Date | Any day with data | Latest day | Day shown; falls back to the nearest earlier day | `d` |
| Columns | Contracts, Relative (M1…), Quarters, Seasons, Half-years, Years | Contracts | What a column is (see below) | `v` |
| Show | 6, 12, 24, 36 columns | 12 columns | Number of columns; the header says "12 of 36 shown" when more exist | `n` |
| Compare with | 1D, 1W, 2W, 1M, 3M | 1M | Comparison day 1, 5, 10, 21 or 63 trading days back | `cmp` |
| or a date | Any day before **Date** | Empty | Comparison day of your choice (nearest earlier day with data) | `cd` |
| Show in cells | IV change, Percentile, Z-score | IV change | Second number in each cell and the cell colour | `mx` |
| Historical window (Vol Context panel) | 6M, 1Y, 3Y, All | 1Y | History used by percentile, z-score, the smile panel and the cell history | `h` |
| Selected cell | Any delta and column | ATM, first column | Which smile and history open below | `delta`, `rank` |

Some deployments offer only 6M, 1Y and 3Y in **Historical window**.

## Reading the result

### Columns

* **Contracts.** One column per listed option, named by the option's own expiry month. The header shows days to
  expiry and the rank; its tooltip names the future the option exercises into. Changes compare the **same contract** on
  both dates.
* **Relative (M1…).** M1 is the front listed option with at least 5 days left, M2 the next, and so on. Changes compare
  the **same rank**, so after an expiry M1 is a different contract.
* **Quarters, Seasons, Half-years, Years.** Each column is an option strip: one option per member month at a common
  strike. The header shows days to the first expiry and how many months are in the strip ("3/3 mo"). A period drops
  once its first month is within 5 days of expiry. Changes compare the **same named period**.

### Cells

The large number is implied vol in percent. The small number depends on **Show in cells**:

* **IV change**: today minus the comparison date, in vol points. Blue is vol down, red is vol up.
* **Percentile**: the share of days in the window with lower vol in the **same column rank** (M1, M2 …, or the n-th
  period); ties count half. 50% is the median day.
* **Z-score**: (today − average) ÷ standard deviation over the same days.

Percentile and z-score are empty when the column has fewer than 20 days of history in the window. A cell with no
number ("—") is not supported by the listed strikes. Two markers can follow the vol:

* **w**: read from settlement-wing vols, beyond the fitted smile.
* **\***: incomplete strip, where a member month is not listed yet or not priced. The same mark appears in the
  column header.

### Smile panel

The panel title gives the column, days to expiry and its forward. Its table lists, per delta, the **Strike** (the
**Strip strike** for a period), **IV %**, **IV change since** the comparison date and the **OTM premium** (for a period,
**OTM premium, sum**). The premium is a model price on the fitted smile, not a listed settlement. The panel also
compares the smile with its history:

* **Smile**: **Absolute**, or **Relative to ATM** (each smile minus its own ATM vol, so you compare shape alone).
* **Reference**: **Rolling rank** (whichever contract held this rank each day) or **Similar DTE** (every contract
  within ± 5, 10 or 20 days to expiry of today's; default ± 10).
* Rows for the median, percentile and **robust z** = (now − median) ÷ (1.4826 × median absolute deviation), plus
  **History coverage**. A ⚠ on coverage means the gaps fall mostly on high-vol days, so that delta's history is biased
  low.

### Cell history and Vol Context

The **History** chart shows the selected cell's implied vol through the window, with its forward on a hidden scale.
For contracts and ranks it follows the rolling rank, and the note says how many times the column rolled. For periods,
**History follows** lets you switch between the named period through its own life (complete strips only) and
**rank n**. The right-hand panel shows how long vol spent at each level, older to newer.

The **Vol Context** panel gives **Last IV**, **Average**, **Percentile** and **Z-score** against the reference
population, the recent changes with their move percentile, and smile relative-value figures.

### Download CSV

**Download CSV** exports every column of the current view, not just the ones shown. Each row is one cell: date,
market, view, column, rank, delta, the contract detail, IV, change, percentile, z-score, days of history, strike,
premium and status. Vols and changes are decimals (0.55 = 55%).

## Example

Open `/report?m=BRENT&d=2026-07-13`. With **Contracts** and **1M**, the front contract N26 (15 days, M1) shows ATM
65.6% and +19.2 points since 12 Jun 2026. Its forward is 83.30. Click the cell: the smile table gives the 25C strike as
93.57 at 76.3% vol. With the default **Rolling rank** reference over **1Y**, the comparison uses 257 smiles from 13
contracts. Vol Context shows Last IV 65.6%, Average 46.5%, Percentile 78%.

The Radar flags this day at 60.4% ATM: that is the 30D constant-maturity point, interpolated between N26 and Q26, not
the M1 contract.

## Limitations

* Points beyond every listed strike stay empty; nothing is extrapolated.
* Percentile and z-score need at least 20 days of history in the window.
* In Relative view, a change across an expiry compares two different contracts.
* A preset comparison is empty when there is no data close enough to that many trading days back.
* Incomplete strips (**\***) have no percentile or z-score; the named-period history uses complete strips only.
* EUA carbon offers only Contracts and Relative columns; seasons exist only for TTF gas and Henry Hub gas.

## How it's calculated

Deltas, the smile, settlement wings and period strips are explained in
[How ML Data and Vol Radar compute implied volatility](https://docs.allasso.ch/kb/volatility/implied-vol-calculation.md).

## Related

* [Radar](https://docs.allasso.ch/apps/vol-radar/radar.md)
* [Investigate a Radar move](https://docs.allasso.ch/apps/vol-radar/radar-move.md)
* [Vol Radar overview](https://docs.allasso.ch/apps/vol-radar/overview.md)


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