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

# List signals

> Signals first detected in a date range, or with `date`, the signals active on that day with their status then.



## OpenAPI

````yaml /api-reference/vol-radar/openapi.json get /v1/signals
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:
    get:
      tags:
        - Signals
      summary: List signals
      description: >-
        Signals first detected in a date range, or with `date`, the signals
        active on that day with their status then.
      operationId: signals
      parameters:
        - name: date
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                format: date
              - type: 'null'
            description: >-
              Status on this day (point in time). Default status filter then:
              active.
            title: Date
          description: >-
            Status on this day (point in time). Default status filter then:
            active.
        - name: from
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                format: date
              - type: 'null'
            description: 'First detected on or after (default: 30 days before the last day)'
            title: From
          description: 'First detected on or after (default: 30 days before the last day)'
        - name: to
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                format: date
              - type: 'null'
            description: First detected on or before
            title: To
          description: First detected on or before
        - name: market
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              Comma-separated market ids, e.g. COM.TTF.ICE (a pair:
              COM.BRN.ICE:COM.WTI.CME)
            title: Market
          description: >-
            Comma-separated market ids, e.g. COM.TTF.ICE (a pair:
            COM.BRN.ICE:COM.WTI.CME)
        - name: metric
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Comma-separated metric ids
            title: Metric
          description: Comma-separated metric ids
        - name: bucket
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Comma-separated buckets (30D, 90D, 180D, M1)
            title: Bucket
          description: Comma-separated buckets (30D, 90D, 180D, M1)
        - name: kind
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: 'Comma-separated: shock, extreme, flip, seasonal, corr, activity'
            title: Kind
          description: 'Comma-separated: shock, extreme, flip, seasonal, corr, activity'
        - name: tier
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: 'Peak tier: notable, watch'
            title: Tier
          description: 'Peak tier: notable, watch'
        - name: status
          in: query
          required: false
          schema:
            anyOf:
              - $ref: '#/components/schemas/Status'
              - type: 'null'
            description: new / escalated / ongoing / active (any of the three) / resolved
            title: Status
          description: new / escalated / ongoing / active (any of the three) / resolved
        - name: discovery
          in: query
          required: false
          schema:
            anyOf:
              - type: boolean
              - type: 'null'
            description: 'true: published as a Discovery on its first day'
            title: Discovery
          description: 'true: published as a Discovery on its first day'
        - name: changed_since
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              Only signals whose content changed after this UTC time, e.g.
              2026-11-03T12:05:36Z (pass the largest `updated_at` you have);
              adds `withdrawn`
            title: Changed Since
          description: >-
            Only signals whose content changed after this UTC time, e.g.
            2026-11-03T12:05:36Z (pass the largest `updated_at` you have); adds
            `withdrawn`
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            maximum: 1000
            minimum: 1
            default: 100
            title: Limit
        - name: offset
          in: query
          required: false
          schema:
            type: integer
            minimum: 0
            default: 0
            title: Offset
      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'
                date: '2026-11-02'
                count: 8
                limit: 2
                offset: 0
                signals:
                  - 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: new
                    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'
                  - id: 73bb346c1d24
                    signal_id: >-
                      COM.BRN.ICE:COM.WTI.CME|30D|return_correlation|corr|60|-1|2026-10-21
                    market: COM.BRN.ICE:COM.WTI.CME
                    market_name: BRENT–WTI
                    market_short: BRENT–WTI
                    bucket: 30D
                    metric: return_correlation
                    metric_label: 60-day return correlation
                    kind: corr
                    kind_label: Cross-market
                    horizon: 60
                    direction: -1
                    first_detected: '2026-10-21'
                    last_observed: '2026-11-03'
                    resolved_at: null
                    status: ongoing
                    tier: notable
                    opening_tier: watch
                    score: 2.1001654928444697
                    peak_score: 3.354999669391587
                    n_escalations: 1
                    discovery: true
                    headline: BRENT–WTI — BRENT–WTI correlation at a 5-year low
                    summary: >-
                      BRENT and WTI move together less closely than usual:
                      60-day return correlation +0.96 (lowest 2% of 5 years)
                    value: 0.9600003231389097
                    value_fmt: '+0.96'
                    statistic:
                      type: percentile
                      value: 0.017857142857142856
                      text: 2nd percentile of the past 5 years
                    analog_count: 6
                    evidence: limited evidence
                    has_structures: false
                    first_seen_at: '2026-11-03T12:05:36Z'
                    updated_at: '2026-11-04T09:39:04Z'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    Status:
      type: string
      enum:
        - new
        - escalated
        - ongoing
        - active
        - resolved
      title: Status
    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.