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

# Save current screener filters for daily closing match notifications

> Personal saved filters, independent of workspace role. Registered account required. API scope and verified account email are checked server-side; email is opt-in. At most 10 filters/account. Daily matches use finalized exchange closes. One combined email/account/day, subject to delivery budget.



## OpenAPI

````yaml https://quantura.studio/api/openapi.json post /me/screener-alerts
openapi: 3.1.0
info:
  title: Quantura Forecast Intelligence API
  version: 1.0.0
  description: >-
    Versioned access to Quantura forecasts, collaborator-aware workspaces,
    screeners, datasets, and provenance metadata.
  contact:
    name: Quantura
    url: https://quantura.studio/contact
  license:
    name: Quantura API Terms
    url: https://quantura.studio/terms
servers:
  - url: https://quantura.studio/api/v1
security:
  - bearerAuth: []
tags:
  - name: Access
    description: Identity, token scopes, plans, and effective workspace access.
  - name: Workspaces
    description: Resources are authorized against current membership on every request.
  - name: Uploaded CSVs
    description: Workspace-isolated CSV metadata, organization, and authorized exports.
  - name: Datasets
    description: Licensing-aware catalog and schema metadata.
  - name: Forecasts
    description: Prospective forecasts and immutable probability trajectories.
  - name: Ensemble Forecasts
    description: >-
      Asynchronous probabilistic time-series ensemble jobs and reproducible
      presets.
  - name: Backtests
    description: >-
      Asynchronous point-in-time ensemble-quantile simulations and versioned
      strategy exports; never live order execution.
paths:
  /me/screener-alerts:
    post:
      tags:
        - Screener
      summary: Save current screener filters for daily closing match notifications
      description: >-
        Personal saved filters, independent of workspace role. Registered
        account required. API scope and verified account email are checked
        server-side; email is opt-in. At most 10 filters/account. Daily matches
        use finalized exchange closes. One combined email/account/day, subject
        to delivery budget.
      operationId: saveScreenerAlert
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
              required:
                - name
                - filters
                - email
              properties:
                name:
                  type: string
                  minLength: 1
                  maxLength: 80
                email:
                  type: boolean
                  description: Explicit email opt-in; verified account address only.
                filters:
                  $ref: '#/components/schemas/ScreenerAlertFilters'
            example:
              name: Average P50 comparison
              email: false
              filters:
                quantileRules:
                  - quantile: p50
                    statistic: avg
                    operator: gt
                    percent: 10
      responses:
        '201':
          description: Saved or replaced identical normalized filters
          content:
            application/json:
              schema:
                type: object
              example:
                data:
                  name: Average P50 comparison
                  email: false
                  filters:
                    quantileRules:
                      - quantile: p50
                        statistic: avg
                        operator: gt
                        percent: 10
                  id: aaaaaaaaaaaaaaaaaaaaaaaa
                  created_at: '2026-09-18T21:00:00Z'
        '401':
          description: Request rejected
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
        '403':
          description: Request rejected
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
        '422':
          description: Request rejected
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
        '429':
          description: Request rejected
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
        '503':
          description: Request rejected
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
components:
  schemas:
    ScreenerAlertFilters:
      type: object
      additionalProperties: false
      properties:
        search:
          type: string
          maxLength: 80
          default: ''
        universe:
          type: string
          enum:
            - all
            - sp500
            - nasdaq
            - etf
          default: all
        marketCap:
          type: string
          enum:
            - all
            - mega
            - large
            - mid
            - small
            - micro
          default: all
        minMarketCap:
          type:
            - number
            - 'null'
          minimum: 0
          default: null
        maxMarketCap:
          type:
            - number
            - 'null'
          minimum: 0
          default: null
        positions:
          type: array
          default: []
          items:
            type: string
            enum:
              - below-p01
              - above-p01
              - below-p10
              - above-p10
              - below-p50
              - above-p50
              - below-p90
              - above-p90
              - below-p99
              - above-p99
        quantileRules:
          type: array
          maxItems: 12
          default: []
          items:
            type: object
            additionalProperties: false
            required:
              - quantile
              - statistic
              - operator
              - percent
            properties:
              quantile:
                type: string
                enum:
                  - p01
                  - p10
                  - p25
                  - p50
                  - p75
                  - p90
                  - p99
              statistic:
                type: string
                enum:
                  - min
                  - max
                  - avg
              operator:
                type: string
                enum:
                  - gt
                  - gte
                  - lt
                  - lte
              percent:
                type: number
                minimum: -100000
                maximum: 100000
                description: >-
                  Offset from price in percent: gt/gte add the offset; lt/lte
                  subtract its magnitude. Below by 10 means comparison with 90%
                  of price. Legacy negative below offsets remain equivalent.
        sort:
          type: string
          enum:
            - ticker
            - company
            - actualPrice
            - marketCap
            - p10
            - p50
            - p90
            - distanceP10
            - distanceP50
            - distanceP90
            - lastUpdate
          default: ticker
        direction:
          type: string
          enum:
            - asc
            - desc
          default: asc
        statistic:
          type: string
          enum:
            - row
            - min
            - max
            - avg
          description: Presentation-only; use quantileRules to filter.
    ApiError:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          required:
            - code
            - message
            - request_id
          properties:
            code:
              type: string
            message:
              type: string
            request_id:
              type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: Quantura API key

````

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