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

> The Radar grid on a day: every market, metric and bucket, with the signals active in each cell.



## OpenAPI

````yaml /api-reference/vol-radar/openapi.json get /v1/snapshot
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/snapshot:
    get:
      tags:
        - Market data
      summary: Get snapshot
      description: >-
        The Radar grid on a day: every market, metric and bucket, with the
        signals active in each cell.
      operationId: snapshot
      parameters:
        - name: date
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                format: date
              - type: 'null'
            description: 'Default: the last day; else the latest day on or before'
            title: Date
          description: 'Default: the last day; else the latest day 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
            title: Market
          description: Comma-separated market ids, e.g. COM.TTF.ICE
      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'
                cells:
                  - market: COM.TTF.ICE
                    metric: atm_ts_30d_180d
                    bucket: 30D
                    value: 0.28964695255476647
                    pct: 0.8042096902303415
                    median: 0.06095296814620882
                    'n': 1259
                    z: 0.08781766550515274
                    band: 0
                    qc: ok
                    qc_fail: false
                    signals: []
                  - market: COM.TTF.ICE
                    metric: bf_10
                    bucket: 30D
                    value: 0.12063645209855478
                    pct: 0.5682989690721649
                    median: 0.11145464970677688
                    'n': 1164
                    z: 1.426694614432225
                    band: 0
                    qc: ok
                    qc_fail: false
                    signals: []
                  - market: COM.TTF.ICE
                    metric: bf_25
                    bucket: 30D
                    value: 0.05500884707823461
                    pct: 0.7125
                    median: 0.0378866281179466
                    'n': 1240
                    z: 1.7242668032630952
                    band: 0
                    qc: ok
                    qc_fail: false
                    signals: []
                note: >-
                  pct: the level's percentile within the trailing 5 years (<=
                  date); z: the last change in units of its usual daily change
                  (past year); band: +1 / -1 in the top / bottom 10% of 5 years
                  (a level band, not a Radar signal).
        '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.