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

# Get structures

> How option structures did after earlier cases like this signal (notable discoveries in single markets only). Model prices.



## OpenAPI

````yaml /api-reference/vol-radar/openapi.json get /v1/signals/{id}/structures
openapi: 3.1.0
info:
  title: Allasso Vol Radar API
  description: >
    Volatility Radar signals for energy and environmental markets: what moved,
    how rare it

    was against the market's own history, and what followed earlier moves of the
    same kind.


    **Descriptive, not a forecast.** Statistics of past market data; not
    investment advice.


    * **Markets** are Allasso market ids (`COM.TTF.ICE`, see `/v1/markets`); a
    market pair joins two with `:`
      (`COM.BRN.ICE:COM.WTI.CME`). `market_short` (TTF) is for display only.
    * A **signal** is one Radar condition from the day it opened to the day it
    resolved. `id` is a short
      stable id; `signal_id` the readable key (`market|bucket|metric|kind|horizon|direction|first day`).
    * `discovery` is true when it was published as a Discovery on its first day;
    false when the lifecycle
      opened it while the detector held the alert back (the same move was already flagged).
    * **Point in time**: a signal's evidence and earlier-case outcomes use only
    data known on its first
      day. `realised` is what followed this signal, null until enough sessions have passed.
    * **Incremental pulls**: each signal has `updated_at`, the build at which
    anything the API serves about
      it last changed. Pass the largest `updated_at` you have seen as `changed_since` to get only what
      changed since, plus the signals `withdrawn` since then.
    * **Withdrawn**: a signal an upstream restatement removed answers `410 Gone`
    with its last known content.

    * **Structures** (`/v1/signals/{id}/structures`): notable discoveries only,
    priced on the signal's first
      day from model prices, front expiry, held 20 sessions, costs 0.5 vol pt per leg each way.
    * **Caching**: responses carry an `ETag` (per run and URL); send
    `If-None-Match` to get `304` when
      nothing changed. A new run arrives once a day.
  version: 1.1.0
servers:
  - url: https://allasso.app/vol-radar-api
security:
  - ApiKey: []
tags:
  - name: Signals
  - name: Market data
  - name: Reference
paths:
  /v1/signals/{id}/structures:
    get:
      tags:
        - Signals
      summary: Get structures
      description: >-
        How option structures did after earlier cases like this signal (notable
        discoveries in single markets only). Model prices.
      operationId: structures
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
            title: Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              example:
                run:
                  run_id: 20261104T155718Z-4bdabbb8
                  created_at: '2026-11-04T15:57:18Z'
                  radar_version: 1.3.0
                  data_to: '2026-11-03'
                signal:
                  id: 8aa995939401
                  signal_id: COM.EUA.ICE|30D|iv_atm|seasonal||-1|2026-11-02
                  market: COM.EUA.ICE
                  market_name: EUA carbon
                  market_short: EUA
                  bucket: 30D
                  metric: iv_atm
                  metric_label: ATM implied vol
                  kind: seasonal
                  kind_label: Seasonal
                  horizon: null
                  direction: -1
                  first_detected: '2026-11-02'
                  last_observed: '2026-11-03'
                  resolved_at: null
                  status: null
                  tier: notable
                  opening_tier: notable
                  score: 2.9752131883645445
                  peak_score: 3.719016485455709
                  n_escalations: 0
                  discovery: true
                  headline: EUA carbon — ATM implied vol unusually low for November
                  summary: >-
                    ATM implied vol at 22.7%: unusually low for November vs
                    earlier years (0th percentile)
                  value: 0.22702783263952306
                  value_fmt: 22.7%
                  statistic:
                    type: percentile
                    value: 0
                    text: 0th percentile for the month
                  analog_count: 6
                  evidence: limited evidence
                  has_structures: true
                  first_seen_at: '2026-11-03T12:05:36Z'
                  updated_at: '2026-11-04T09:39:04Z'
                as_known_on: '2026-11-02'
                params:
                  m: 1
                  hold: '20'
                  cost: 0.5
                prices: model prices on a fitted smile grid, not exchange settlements
                structures:
                  - id: calendar.25call.w2.r1x1
                    label: Call calendar 25Δ, back +2
                    results:
                      - side: long
                        hedged: false
                        suggested: false
                        'n': 6
                        median: -0.002543145377842939
                        share_profitable: 0.16666666666666666
                        worst: -0.004012052669832857
                      - side: long
                        hedged: true
                        suggested: false
                        'n': 6
                        median: -0.0036358565746528555
                        share_profitable: 0.16666666666666666
                        worst: -0.028844077015770388
                      - side: short
                        hedged: false
                        suggested: false
                        'n': 6
                        median: -0.003882067075910112
                        share_profitable: 0
                        worst: -0.007265183368310879
                      - side: short
                        hedged: true
                        suggested: false
                        'n': 6
                        median: -0.0036609897161516804
                        share_profitable: 0.16666666666666666
                        worst: -0.007659737896480956
                  - id: calendar.25put.w2.r1x1
                    label: Put calendar 25Δ, back +2
                    results:
                      - side: long
                        hedged: false
                        suggested: false
                        'n': 6
                        median: -0.0027607832446679636
                        share_profitable: 0.16666666666666666
                        worst: -0.00473538696815804
                      - side: long
                        hedged: true
                        suggested: false
                        'n': 6
                        median: -0.003912130598621288
                        share_profitable: 0.16666666666666666
                        worst: -0.010547956015920896
                      - side: short
                        hedged: false
                        suggested: false
                        'n': 6
                        median: -0.0033010621007780964
                        share_profitable: 0.16666666666666666
                        worst: -0.011304783733899645
                      - side: short
                        hedged: true
                        suggested: false
                        'n': 6
                        median: -0.0029692034099688376
                        share_profitable: 0.3333333333333333
                        worst: -0.007563482849512827
                note: >-
                  The same structure entered after each earlier case like this
                  one (the most recent 20 whose exit was before the signal's
                  day), P&L net of costs as a fraction of the futures price.
                  `suggested`: the side the Radar lists first for this kind of
                  move; never advice. Model prices.
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    ApiKey:
      type: apiKey
      in: header
      name: Authorization
      description: >-
        `Key <your API key>`. Create the key on allasso.app: your profile, then
        API Keys.

````

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