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

# Get forecast observations

> Returns genuine selected-side targets (Kalshi closing ask, Polymarket US display quote) or stock closes after the immutable input cutoff. The first prediction-row minute is retained when available, even outside the most recent 500 observations; worker completion does not move this comparison to another minute. A quote preceding publication is retrospective, not a backdated fill. Stock rows include interval and exchange session_date metadata; minute closes are not final daily closes. Does not run models or revise predictions. Poll no faster than once per minute. Stock overlays have no fixed 90-day cutoff-age limit: retained forecast-interval closes support 120/180-day replays, bounded to 2,000 rows; recent stock minutes use a seven-day window. Prediction-market and perpetual live overlays expire 90 days after input cutoff and expose their availability state. Provider retention still applies. Dataset-only jobs return no live observations.



## OpenAPI

````yaml /docs/api/openapi.json get /v1/ensemble-forecasts/{forecast_id}/observations
openapi: 3.1.0
info:
  title: Quantura API
  version: 1.0.0
  description: >-
    Search markets and public datasets, download historical observations, create
    forecasts and inspect screener quantiles.
  contact:
    name: Quantura
    url: https://quantura.studio/contact
  license:
    name: Quantura API Terms
    url: https://quantura.studio/terms
servers:
  - url: https://quantura.studio/api
security:
  - bearerAuth: []
  - clerkOAuth:
      - openid
      - profile
      - email
tags:
  - name: Access
  - name: Forecast
  - name: Screener
  - name: Search
  - name: Download
  - name: Scout
paths:
  /v1/ensemble-forecasts/{forecast_id}/observations:
    servers:
      - url: https://quantura.studio/api
    get:
      tags:
        - Forecast
      summary: Get forecast observations
      description: >-
        Returns genuine selected-side targets (Kalshi closing ask, Polymarket US
        display quote) or stock closes after the immutable input cutoff. The
        first prediction-row minute is retained when available, even outside the
        most recent 500 observations; worker completion does not move this
        comparison to another minute. A quote preceding publication is
        retrospective, not a backdated fill. Stock rows include interval and
        exchange session_date metadata; minute closes are not final daily
        closes. Does not run models or revise predictions. Poll no faster than
        once per minute. Stock overlays have no fixed 90-day cutoff-age limit:
        retained forecast-interval closes support 120/180-day replays, bounded
        to 2,000 rows; recent stock minutes use a seven-day window.
        Prediction-market and perpetual live overlays expire 90 days after input
        cutoff and expose their availability state. Provider retention still
        applies. Dataset-only jobs return no live observations.
      operationId: getEnsembleForecastObservations
      parameters:
        - name: forecast_id
          in: path
          required: true
          description: Forecast id or unique slug.
          schema:
            type: string
      responses:
        '200':
          description: >-
            Authorized current observations, possibly empty when no new data is
            available.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      forecast_id:
                        type: string
                      rows:
                        type: array
                        items:
                          type: object
                          properties:
                            timestamp:
                              type: string
                              format: date-time
                            target:
                              type: number
                      input_cutoff:
                        type: string
                        format: date-time
                      observed_at:
                        type: string
                        format: date-time
                      availability:
                        type: string
                      refresh_after_seconds:
                        type: integer
                  meta:
                    type: object
              example:
                data:
                  forecast_id: ens_example
                  rows:
                    - timestamp: '2026-09-11T22:01:00Z'
                      target: 0.51
                  input_cutoff: '2026-09-11T22:00:00Z'
                  observed_at: '2026-09-11T22:01:10Z'
                  availability: available
                  refresh_after_seconds: 60
                meta:
                  api_version: v1
        '401':
          description: Authentication failed
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: object
                    required:
                      - code
                      - message
                      - request_id
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                      request_id:
                        type: string
                        format: uuid
        '403':
          description: Scope, plan, or workspace authorization denied
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: object
                    required:
                      - code
                      - message
                      - request_id
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                      request_id:
                        type: string
                        format: uuid
        '429':
          description: Rate limit exceeded
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: object
                    required:
                      - code
                      - message
                      - request_id
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                      request_id:
                        type: string
                        format: uuid
      security:
        - bearerAuth: []
        - clerkOAuth:
            - openid
            - profile
            - email
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: Clerk personal API key or legacy Quantura key
    clerkOAuth:
      type: oauth2
      description: >-
        Clerk authorization code with PKCE S256. Pass
        resource=https://quantura.studio on authorization and token requests.
        Paid Pro, enterprise or verified administrator API access is required.
      flows:
        authorizationCode:
          authorizationUrl: https://clerk.quantura.studio/oauth/authorize
          tokenUrl: https://clerk.quantura.studio/oauth/token
          refreshUrl: https://clerk.quantura.studio/oauth/token
          scopes:
            openid: Identify the Quantura account
            profile: Resolve the account profile
            email: Verify account email
            offline_access: Refresh access after expiry

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.