> ## 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 strike advisor recommendations

> Get timeframe-aware options contract recommendations scored across 5 signal
families: dealer positioning, timing, flow alignment, IV favorability, and
liquidity quality.

Returns a primary recommendation plus up to 2 alternatives, each with
per-signal scores and rationale.

## Timeframes

- **intraday**: 0-2 DTE, delta 0.40-0.60, liquidity-heavy weighting
- **swing**: 7-21 DTE, delta 0.30-0.55, balanced weighting
- **position**: 21-45 DTE, delta 0.20-0.45, timing-heavy weighting

## Confidence Levels

- **HIGH** (>=70): Strong multi-signal alignment
- **MODERATE** (>=50): Reasonable setup with some signals confirming
- **LOW** (>=40): Marginal — proceed with caution
- **INSUFFICIENT** (<40): Not recommended (filtered out)

## IV Regime Advisory

When IV rank > 70%, the response includes an advisory note suggesting
defined-risk structures. When IV rank < 30%, the note confirms favorable
conditions for buying premium.



## OpenAPI

````yaml /api/openapi.json get /api/graph/v1/options/{symbol}/strike-advisor
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}/strike-advisor:
    get:
      tags:
        - Strike Advisor
      summary: Get strike advisor recommendations
      description: >-
        Get timeframe-aware options contract recommendations scored across 5
        signal

        families: dealer positioning, timing, flow alignment, IV favorability,
        and

        liquidity quality.


        Returns a primary recommendation plus up to 2 alternatives, each with

        per-signal scores and rationale.


        ## Timeframes


        - **intraday**: 0-2 DTE, delta 0.40-0.60, liquidity-heavy weighting

        - **swing**: 7-21 DTE, delta 0.30-0.55, balanced weighting

        - **position**: 21-45 DTE, delta 0.20-0.45, timing-heavy weighting


        ## Confidence Levels


        - **HIGH** (>=70): Strong multi-signal alignment

        - **MODERATE** (>=50): Reasonable setup with some signals confirming

        - **LOW** (>=40): Marginal — proceed with caution

        - **INSUFFICIENT** (<40): Not recommended (filtered out)


        ## IV Regime Advisory


        When IV rank > 70%, the response includes an advisory note suggesting

        defined-risk structures. When IV rank < 30%, the note confirms favorable

        conditions for buying premium.
      operationId: get_strike_advisor_api_graph_v1_options__symbol__strike_advisor_get
      parameters:
        - name: symbol
          in: path
          required: true
          schema:
            type: string
            title: Symbol
        - name: direction
          in: query
          required: false
          schema:
            type: string
            pattern: ^(bullish|bearish)$
            description: Trade direction
            default: bullish
            title: Direction
          description: Trade direction
        - name: timeframe
          in: query
          required: false
          schema:
            type: string
            pattern: ^(intraday|swing|position)$
            description: Trading timeframe
            default: swing
            title: Timeframe
          description: Trading timeframe
        - name: target_price
          in: query
          required: false
          schema:
            anyOf:
              - type: number
              - type: 'null'
            description: Optional target price for FPT-based timing
            title: Target Price
          description: Optional target price for FPT-based timing
      responses:
        '200':
          description: Strike advisor recommendations
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StrikeAdvisorResponse'
        '422':
          description: Invalid parameters
        '504':
          description: Query timeout
components:
  schemas:
    StrikeAdvisorResponse:
      properties:
        symbol:
          type: string
          title: Symbol
          description: Ticker symbol
        direction:
          type: string
          title: Direction
          description: 'Trade direction: ''bullish'' or ''bearish'''
        timeframe:
          type: string
          title: Timeframe
          description: 'Timeframe: ''intraday'', ''swing'', or ''position'''
        underlying_price:
          anyOf:
            - type: number
            - type: 'null'
          title: Underlying Price
          description: Current underlying spot price
        primary:
          anyOf:
            - $ref: >-
                #/components/schemas/app__models__strike_advisor_recommendation__ContractRecommendationResponse
            - type: 'null'
          description: Primary recommendation (highest composite score)
        alternatives:
          items:
            $ref: >-
              #/components/schemas/app__models__strike_advisor_recommendation__ContractRecommendationResponse
          type: array
          title: Alternatives
          description: Up to 2 alternative recommendations
        iv_regime_note:
          anyOf:
            - type: string
            - type: 'null'
          title: Iv Regime Note
          description: IV regime advisory text (high/low IV warning)
        context:
          additionalProperties: true
          type: object
          title: Context
          description: Scoring context (status, candidates evaluated, etc.)
        source_time:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Source Time
          description: Newest exact options_data observation used by the scorer
        availability:
          type: string
          title: Availability
          default: unavailable
        formula_version:
          type: string
          title: Formula Version
          default: strike-advisor-scorer-v1
        dependencies:
          items:
            type: string
          type: array
          title: Dependencies
        availability_qualifier:
          anyOf:
            - type: string
            - type: 'null'
          title: Availability Qualifier
      type: object
      required:
        - symbol
        - direction
        - timeframe
      title: StrikeAdvisorResponse
      description: Complete strike advisor output for a symbol + direction + timeframe.
      examples:
        - alternatives: []
          context:
            candidates_evaluated: 42
            passed_gates: 18
            status: scored
          direction: bullish
          primary:
            ask: 12.2
            bid: 11.8
            composite_score: 74.5
            confidence: HIGH
            contract_symbol: NVDA260321C00880000
            delta: 0.42
            expiration: '2026-03-21'
            mid: 12
            option_type: call
            rationale: >-
              Bullish swing — dealer: long gamma regime (+15); timing: 16 DTE in
              sweet spot (+28)
            signals:
              - details:
                  gex_regime: long_gamma
                name: dealer
                rationale: long gamma regime (+15); near max pain $870 (+15)
                score: 75
            strike: 880
          symbol: NVDA
          timeframe: swing
          underlying_price: 875.5
    app__models__strike_advisor_recommendation__ContractRecommendationResponse:
      properties:
        contract_symbol:
          type: string
          title: Contract Symbol
          description: Full OCC contract symbol
        strike:
          type: number
          title: Strike
          description: Strike price
        expiration:
          type: string
          title: Expiration
          description: Expiration date as YYYY-MM-DD string
        option_type:
          type: string
          title: Option Type
          description: 'Option type: ''call'' or ''put'''
        delta:
          anyOf:
            - type: number
            - type: 'null'
          title: Delta
          description: Contract delta
        bid:
          anyOf:
            - type: number
            - type: 'null'
          title: Bid
          description: Bid price
        ask:
          anyOf:
            - type: number
            - type: 'null'
          title: Ask
          description: Ask price
        mid:
          anyOf:
            - type: number
            - type: 'null'
          title: Mid
          description: Mid price
        composite_score:
          type: number
          title: Composite Score
          description: Weighted composite score (0-100)
        confidence:
          type: string
          title: Confidence
          description: 'Confidence classification: HIGH, MODERATE, LOW, or INSUFFICIENT'
        rationale:
          type: string
          title: Rationale
          description: Human-readable summary of top signals
        signals:
          items:
            $ref: '#/components/schemas/SignalScoreResponse'
          type: array
          title: Signals
          description: Per-signal breakdowns
        open_interest:
          anyOf:
            - type: integer
            - type: 'null'
          title: Open Interest
          description: Top-level open interest (promoted from liquidity signal)
        volume:
          anyOf:
            - type: integer
            - type: 'null'
          title: Volume
          description: Top-level day volume (promoted from liquidity signal)
        spread_pct:
          anyOf:
            - type: number
            - type: 'null'
          title: Spread Pct
          description: >-
            Top-level bid/ask spread percentage of mid (promoted from liquidity
            signal)
      type: object
      required:
        - contract_symbol
        - strike
        - expiration
        - option_type
        - composite_score
        - confidence
        - rationale
      title: ContractRecommendationResponse
      description: A scored contract recommendation.
    SignalScoreResponse:
      properties:
        name:
          type: string
          title: Name
          description: Signal family name (dealer, timing, flow, iv, liquidity)
        score:
          anyOf:
            - type: number
            - type: 'null'
          title: Score
          description: Score 0-100, or null when source data is unavailable (fail-closed)
        rationale:
          type: string
          title: Rationale
          description: Human-readable rationale for this signal
        details:
          additionalProperties: true
          type: object
          title: Details
          description: Additional signal-specific details
      type: object
      required:
        - name
        - score
        - rationale
      title: SignalScoreResponse
      description: A single signal family score with rationale.

````