> ## Documentation Index
> Fetch the complete documentation index at: https://docs.beliefsystems.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# V1 List Volatility

> The Belief Volatility catalog. An unlaunched surface is an EMPTY
catalog (indistinguishable from no listed series), never an error.



## OpenAPI

````yaml /api-reference/openapi.json get /v1/volatility
openapi: 3.1.0
info:
  description: >-
    Rules-based benchmark data for prediction markets. Free tier with an API key
    from https://beliefsystems.xyz/developers ; attribution required: "Source:
    Belief Systems (beliefsystems.xyz)". Production, redistribution, and
    commercial use require a license (https://beliefsystems.xyz/license).
  title: Belief Systems Data API
  version: '1.0'
servers:
  - url: https://api.beliefsystems.xyz
security:
  - bearerAuth: []
paths:
  /v1/volatility:
    get:
      tags:
        - public-v1
      summary: V1 List Volatility
      description: |-
        The Belief Volatility catalog. An unlaunched surface is an EMPTY
        catalog (indistinguishable from no listed series), never an error.
      operationId: v1_list_volatility_v1_volatility_get
      parameters:
        - in: header
          name: X-API-Key
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: X-Api-Key
        - in: header
          name: Authorization
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: Authorization
      responses:
        '200':
          content:
            application/json:
              schema:
                additionalProperties: true
                title: Response V1 List Volatility V1 Volatility Get
                type: object
          description: Successful Response
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Error
components:
  schemas:
    Error:
      properties:
        error:
          properties:
            code:
              description: Stable machine-readable error code.
              enum:
                - invalid_api_key
                - ip_rate_limited
                - rate_limited
                - daily_limit_reached
                - not_found
                - invalid_parameter
                - invalid_interval
                - invalid_window
                - method_not_allowed
                - internal_error
                - unavailable
                - error
              type: string
            docsUrl:
              description: Deep link to this code on the limits and errors page.
              type: string
            message:
              type: string
            requestId:
              description: >-
                Correlation id, also returned as the X-Request-Id header. Quote
                it in support requests.
              type: string
          required:
            - code
            - message
            - docsUrl
            - requestId
          type: object
      required:
        - error
      title: Error
      type: object
  securitySchemes:
    bearerAuth:
      description: Data API key (belief_live_…) as a Bearer token.
      scheme: bearer
      type: http

````