> ## 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 Service Index

> The root document: what exists, what it costs you, what you have left.

A developer who hits the base URL used to get a 404. This answers every
limits question in one call and is the portal's test-request target
(DXS-1.0 §5.1). The quota figures are PEEKED, never consumed — this
request already spent its own slot in require_developer_key, and a
reporting endpoint that charges for the report is a bug.



## OpenAPI

````yaml /api-reference/openapi.json get /v1
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:
    get:
      tags:
        - public-v1
      summary: V1 Service Index
      description: |-
        The root document: what exists, what it costs you, what you have left.

        A developer who hits the base URL used to get a 404. This answers every
        limits question in one call and is the portal's test-request target
        (DXS-1.0 §5.1). The quota figures are PEEKED, never consumed — this
        request already spent its own slot in require_developer_key, and a
        reporting endpoint that charges for the report is a bug.
      operationId: v1_service_index_v1_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 Service Index V1 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

````