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

> The markets, with their market ids and data range, and the market pairs.



## OpenAPI

````yaml /api-reference/vol-radar/openapi.json get /v1/markets
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/markets:
    get:
      tags:
        - Reference
      summary: List markets
      description: The markets, with their market ids and data range, and the market pairs.
      operationId: markets
      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'
                markets:
                  - market: COM.TTF.ICE
                    name: TTF gas
                    short: TTF
                    underlying_id: COM.TTF.ICE
                    option_root: COM.TTF.ICE_TFO
                    option_family: COM.TTF.ICE
                    options_supported: true
                    settlement: ICE Endex daily settlement (~17:30 CET)
                    first_date: '2015-02-02'
                    last_date: '2026-11-03'
                    data_to: '2026-11-03'
                  - market: COM.BRN.ICE
                    name: Brent crude
                    short: Brent
                    underlying_id: COM.BRN.ICE
                    option_root: COM.BRN.ICE_BRN
                    option_family: COM.BRN.ICE
                    options_supported: true
                    settlement: ICE Futures Europe daily settlement (19:28-19:30 London)
                    first_date: '2007-08-24'
                    last_date: '2026-11-03'
                    data_to: '2026-11-03'
                  - market: COM.WTI.CME
                    name: WTI crude
                    short: WTI
                    underlying_id: COM.WTI.CME
                    option_root: COM.WTI.CME_CL
                    option_family: COM.WTI.CME
                    options_supported: true
                    settlement: CME NYMEX daily settlement (14:28-14:30 New York)
                    first_date: '2005-12-01'
                    last_date: '2026-11-03'
                    data_to: '2026-11-03'
                  - market: COM.EUA.ICE
                    name: EUA carbon
                    short: EUA
                    underlying_id: COM.EUA.ICE
                    option_root: COM.EUA.ICE_EUA
                    option_family: COM.EUA.ICE
                    options_supported: true
                    settlement: ICE Endex daily settlement (~17:00 London)
                    first_date: '2008-02-01'
                    last_date: '2026-11-03'
                    data_to: '2026-11-03'
                  - market: COM.NG.CME
                    name: Henry Hub gas
                    short: Henry Hub
                    underlying_id: COM.NG.CME
                    option_root: COM.NG.CME_LN
                    option_family: COM.NG.CME
                    options_supported: true
                    settlement: CME NYMEX daily settlement (14:28-14:30 New York)
                    first_date: '2007-10-29'
                    last_date: '2026-11-03'
                    data_to: '2026-11-03'
                  - market: COM.G.ICE
                    name: ICE gasoil
                    short: Gasoil
                    underlying_id: COM.G.ICE
                    option_root: COM.G.ICE_G
                    option_family: COM.G.ICE
                    options_supported: true
                    settlement: ICE Futures Europe daily settlement (17:28-17:30 London)
                    first_date: '2015-02-02'
                    last_date: '2026-11-03'
                    data_to: '2026-11-03'
                  - market: COM.HO.CME
                    name: NY Harbor ULSD
                    short: ULSD
                    underlying_id: COM.HO.CME
                    option_root: COM.HO.CME_HO
                    option_family: COM.HO.CME
                    options_supported: true
                    settlement: CME NYMEX daily settlement (14:28-14:30 New York)
                    first_date: '2005-12-01'
                    last_date: '2026-11-03'
                    data_to: '2026-11-03'
                pairs:
                  - COM.BRN.ICE:COM.G.ICE
                  - COM.BRN.ICE:COM.WTI.CME
                  - COM.G.ICE:COM.HO.CME
                  - COM.TTF.ICE:COM.EUA.ICE
                  - COM.TTF.ICE:COM.NG.CME
components:
  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.