> ## 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 a signal

> One signal by its `id` or `signal_id`: its opening insight and its lifecycle events.



## OpenAPI

````yaml /api-reference/vol-radar/openapi.json get /v1/signals/{id}
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}:
    get:
      tags:
        - Signals
      summary: Get a signal
      description: >-
        One signal by its `id` or `signal_id`: its opening insight and its
        lifecycle events.
      operationId: signal
      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: ongoing
                  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'
                insight:
                  signal_id: COM.EUA.ICE|30D|iv_atm|seasonal||-1|2026-11-02
                  detector: radar
                  detector_version: 1.3.0
                  market: COM.EUA.ICE
                  market_name: EUA carbon
                  date: '2026-11-02'
                  feature: iv_atm
                  feature_label: ATM implied vol
                  bucket: 30D
                  category: volatility
                  category_label: Volatility
                  signal_type: seasonal
                  signal_label: Seasonal
                  horizon: null
                  direction: -1
                  severity: notable
                  status: new
                  status_label: New
                  since: '2026-11-02'
                  lifecycle_only: false
                  nature: REGIME
                  continues_text: Seasonal anomaly remains active
                  continues_rule: while in the outer 6% for the month (entry 3%)
                  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)
                  current_value: 0.22702783263952306
                  value_fmt: 22.7%
                  change: null
                  change_fmt: null
                  change_unit: vol_points
                  statistic:
                    type: percentile
                    value: 0
                    text: 0th percentile for the month
                  reference_window: same month
                  reference: the same calendar month in earlier years
                  reference_population: 30D constant maturity, same market
                  ref_label: >-
                    EUA · ATM IV · 30D constant maturity · November
                    observations, earlier years
                  window_label: November observations, earlier years
                  definition: >-
                    Implied vol at the ATM bucket (forward delta; ATM =
                    at-the-money-forward).
                  title: ATM implied vol unusually low for November
                  market_short: EUA
                  analog_count: 4
                  evidence: insufficient evidence
                  outcome: null
                  quality_status: valid
                  quality_flags:
                    - interpolated
                  quality_warnings:
                    - IV interpolated between listed expiries
                  methodology: >-
                    Detector radar v1.3.0: seasonal vs the same calendar month
                    in earlier years. Descriptive, not a forecast.
                  score: 2.9752131883645445
                  id: 8aa995939401
                lifecycle:
                  - event_date: '2026-11-02'
                    event_type: NEW
                    previous_status: null
                    new_status: NEW
                    metric_value: 0.22702783263952306
                    score: 3.719016485455709
                    tier: notable
        '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.