> ## 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 AI interpretation of options dealer positioning



## OpenAPI

````yaml /api/openapi.json post /api/graph/v1/options/{symbol}/interpret
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}/interpret:
    post:
      tags:
        - Options Interpretation
      summary: Get AI interpretation of options dealer positioning
      operationId: interpret_options_api_graph_v1_options__symbol__interpret_post
      parameters:
        - name: symbol
          in: path
          required: true
          schema:
            type: string
            title: Symbol
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/InterpretRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InterpretResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    InterpretRequest:
      properties:
        expiration:
          anyOf:
            - type: string
            - type: 'null'
          title: Expiration
        direction:
          type: string
          title: Direction
          default: bullish
        template_headline:
          type: string
          title: Template Headline
          default: ''
        gex:
          anyOf:
            - $ref: '#/components/schemas/GEXContext'
            - type: 'null'
        vanna_charm:
          anyOf:
            - $ref: '#/components/schemas/VannaCharmContext'
            - type: 'null'
        options_context:
          anyOf:
            - $ref: '#/components/schemas/OptionsContext-Input'
            - type: 'null'
        strike_advisor:
          anyOf:
            - $ref: '#/components/schemas/StrikeAdvisorContext'
            - type: 'null'
      type: object
      title: InterpretRequest
      description: Request body for the interpret endpoint.
    InterpretResponse:
      properties:
        summary:
          anyOf:
            - type: string
            - type: 'null'
          title: Summary
        key_levels:
          items:
            $ref: '#/components/schemas/KeyLevel'
          type: array
          title: Key Levels
        risk_note:
          anyOf:
            - type: string
            - type: 'null'
          title: Risk Note
        provider:
          anyOf:
            - type: string
            - type: 'null'
          title: Provider
        model:
          anyOf:
            - type: string
            - type: 'null'
          title: Model
        cached:
          type: boolean
          title: Cached
          default: false
        error:
          anyOf:
            - type: string
            - type: 'null'
          title: Error
      type: object
      title: InterpretResponse
      description: Structured interpretation response.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    GEXContext:
      properties:
        regime:
          type: string
          title: Regime
          default: neutral
        total_gex:
          type: number
          title: Total Gex
          default: 0
        gamma_flip_strike:
          anyOf:
            - type: number
            - type: 'null'
          title: Gamma Flip Strike
        pin_strike:
          anyOf:
            - type: number
            - type: 'null'
          title: Pin Strike
        spot_price:
          type: number
          title: Spot Price
          default: 0
        data_quality:
          type: number
          title: Data Quality
          default: 0
        is_aggregate:
          type: boolean
          title: Is Aggregate
          default: true
      type: object
      title: GEXContext
      description: GEX data for interpretation.
    VannaCharmContext:
      properties:
        net_vanna:
          type: number
          title: Net Vanna
          default: 0
        net_charm:
          type: number
          title: Net Charm
          default: 0
        vanna_flip_strike:
          anyOf:
            - type: number
            - type: 'null'
          title: Vanna Flip Strike
        charm_direction:
          type: string
          title: Charm Direction
          default: unknown
      type: object
      title: VannaCharmContext
      description: Vanna-charm data for interpretation.
    OptionsContext-Input:
      properties:
        iv_rank:
          anyOf:
            - type: number
            - type: 'null'
          title: Iv Rank
        iv_term_structure:
          anyOf:
            - type: string
            - type: 'null'
          title: Iv Term Structure
        max_pain:
          anyOf:
            - type: number
            - type: 'null'
          title: Max Pain
        flow_direction:
          type: string
          title: Flow Direction
          default: neutral
        cvd_trend:
          anyOf:
            - type: string
            - type: 'null'
          title: Cvd Trend
        cvd_divergence:
          anyOf:
            - type: string
            - type: 'null'
          title: Cvd Divergence
      type: object
      title: OptionsContext
      description: Market context for interpretation.
    StrikeAdvisorContext:
      properties:
        top_recommendation:
          anyOf:
            - type: string
            - type: 'null'
          title: Top Recommendation
        composite_score:
          type: integer
          title: Composite Score
          default: 0
        confidence:
          type: string
          title: Confidence
          default: INSUFFICIENT
        signal_scores:
          additionalProperties:
            type: integer
          type: object
          title: Signal Scores
      type: object
      title: StrikeAdvisorContext
      description: Strike Advisor recommendation context.
    KeyLevel:
      properties:
        price:
          type: number
          title: Price
        significance:
          type: string
          title: Significance
      type: object
      required:
        - price
        - significance
      title: KeyLevel
      description: A price level with significance explanation.
    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

````