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

# Get batch-computed options analysis summary

> Returns max pain, GEX regime, IV term structure, flow summary, and CVD for a symbol.



## OpenAPI

````yaml /api/openapi.json get /api/graph/v1/options/{symbol}/options-analysis
openapi: 3.1.0
info:
  title: Sequency Graph API
  description: >

    # Sequency Graph-Native Trading API


    Graph-native API for trading intelligence, built on FalkorDB.


    ## Features


    - **Screener**: Filter stocks using graph-native queries with relationship
    expansion

    - **Stock Detail**: Complete stock context with all relationships

    - **Confluence Scoring**: Setup quality assessment with weighted components

    - **Strategy Matching**: Find matching options strategies via graph
    traversal

    - **Market Context**: Current market-wide context for trading decisions


    ## Data Sources


    All data is sourced from the FalkorDB knowledge graph, populated by:

    - Pattern detector (Go) - Technical indicators, patterns

    - Graph sync service - Levels, volume profiles, news, day classification
  version: 1.0.0
servers: []
security: []
paths:
  /api/graph/v1/options/{symbol}/options-analysis:
    get:
      tags:
        - Options Screener
      summary: Get batch-computed options analysis summary
      description: >-
        Returns max pain, GEX regime, IV term structure, flow summary, and CVD
        for a symbol.
      operationId: get_options_analysis_api_graph_v1_options__symbol__options_analysis_get
      parameters:
        - name: symbol
          in: path
          required: true
          schema:
            type: string
            title: Symbol
      responses:
        '200':
          description: Options analysis summary
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OptionsAnalysisResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '504':
          description: Query timeout
components:
  schemas:
    OptionsAnalysisResponse:
      properties:
        symbol:
          type: string
          title: Symbol
          description: Ticker symbol
        underlying_price:
          anyOf:
            - type: number
            - type: 'null'
          title: Underlying Price
          description: Current underlying spot price
        source:
          type: string
          title: Source
          description: >-
            Feed access for underlying_price: 'realtime_sip' | 'delayed' |
            'byok'
          default: realtime_sip
        max_pain:
          anyOf:
            - type: number
            - type: 'null'
          title: Max Pain
          description: Max pain strike price from open interest weighting
        max_pain_quality:
          type: string
          title: Max Pain Quality
          description: 'Max pain reliability flag: ''reliable'' or ''insufficient'''
          default: insufficient
        gex_regime:
          type: string
          title: Gex Regime
          description: 'Gamma exposure regime: ''long_gamma'', ''short_gamma'', or ''neutral'''
          default: neutral
        gex_gamma_flip:
          anyOf:
            - type: number
            - type: 'null'
          title: Gex Gamma Flip
          description: Strike where dealer gamma flips sign
        pin_strike:
          anyOf:
            - type: number
            - type: 'null'
          title: Pin Strike
          description: Strike with highest absolute net gamma (GEX pin strike)
        iv_term_structure:
          anyOf:
            - type: string
            - type: 'null'
          title: Iv Term Structure
          description: >-
            IV term structure shape: 'contango', 'backwardation', 'flat', or
            'humped'
        iv_rank:
          anyOf:
            - type: number
            - type: 'null'
          title: Iv Rank
          description: IV rank (0-100) relative to 252-day history
        flow_direction:
          type: string
          title: Flow Direction
          description: 'Net institutional flow direction: ''bullish'', ''bearish'', or ''neutral'''
          default: neutral
        flow_strength:
          type: number
          title: Flow Strength
          description: Flow signal strength (0-100)
          default: 0
        flow_signal_count_24h:
          type: integer
          title: Flow Signal Count 24H
          description: Number of unusual flow signals in trailing 24 hours
          default: 0
        cvd_trend:
          anyOf:
            - type: string
            - type: 'null'
          title: Cvd Trend
          description: 'CVD trend direction: ''bullish'', ''bearish'', or ''neutral'''
        cvd_divergence:
          anyOf:
            - type: string
            - type: 'null'
          title: Cvd Divergence
          description: >-
            CVD divergence flag: 'bullish_divergence', 'bearish_divergence', or
            None
        computed_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Computed At
          description: Timestamp when this analysis was computed
      type: object
      required:
        - symbol
      title: OptionsAnalysisResponse
      description: |-
        Phase 1 batch options analysis payload for a single symbol.

        Combines max-pain positioning, GEX regime, IV term structure, and
        institutional flow signals into a unified snapshot used downstream
        by the strike advisor scoring engine.
      examples:
        - computed_at: '2026-03-05T15:30:00Z'
          cvd_trend: bullish
          flow_direction: bullish
          flow_signal_count_24h: 5
          flow_strength: 72
          gex_gamma_flip: 860
          gex_regime: long_gamma
          iv_rank: 32.5
          iv_term_structure: contango
          max_pain: 870
          max_pain_quality: reliable
          symbol: NVDA
          underlying_price: 875.5
    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
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError

````