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

> What followed earlier cases like this signal, as known on its first day, and what followed this signal (`realised`).



## OpenAPI

````yaml /api-reference/vol-radar/openapi.json get /v1/signals/{id}/outcomes
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}/outcomes:
    get:
      tags:
        - Signals
      summary: Get outcomes
      description: >-
        What followed earlier cases like this signal, as known on its first day,
        and what followed this signal (`realised`).
      operationId: outcomes
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
            title: Id
        - name: cases
          in: query
          required: false
          schema:
            type: boolean
            description: Include each earlier case's values
            default: false
            title: Cases
          description: Include each earlier case's values
      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'
                outcomes:
                  - outcome: futures
                    label: Futures return
                    unit: logret
                    horizons:
                      - horizon: 1
                        'n': 6
                        evidence: limited evidence
                        median: 0.005409266298117716
                        mean: 0.0030792295914955858
                        p25: -0.006950977409454414
                        p75: 0.013668183803566943
                        share_up: 0.5
                        min: -0.012442822898424915
                        max: 0.014749570191091438
                        realised: -0.006546072768144496
                      - horizon: 5
                        'n': 6
                        evidence: limited evidence
                        median: 0.02105534001659165
                        mean: 0.013930859786282635
                        p25: 0.0030546751219428427
                        p75: 0.027617627270465312
                        share_up: 0.6666666666666666
                        min: -0.015327413912115471
                        max: 0.029942382751144872
                        realised: null
                  - outcome: own
                    label: ATM implied vol
                    unit: volpts
                    horizons:
                      - horizon: 1
                        'n': 6
                        evidence: limited evidence
                        median: 0.0027150763771214698
                        mean: 0.002449227730041382
                        p25: -0.003222911757492876
                        p75: 0.008476000093312688
                        share_up: 0.6666666666666666
                        min: -0.005862062886366648
                        max: 0.009933209649359898
                        realised: 0.00361958434352444
                      - horizon: 5
                        'n': 6
                        evidence: limited evidence
                        median: -0.0014566529530534306
                        mean: -0.0008978316417024937
                        p25: -0.0063099456492076225
                        p75: 0.005009484859957426
                        share_up: 0.5
                        min: -0.011328430261297984
                        max: 0.009617592067487857
                        realised: null
                note: >-
                  Earlier cases: the same kind of signal in the same market, at
                  least 20 sessions apart, with each outcome already known on
                  the signal's first day. Not a forecast.
        '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.