> ## 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 matching trading strategies

> Find matching options strategies via graph traversal.

## Strategy Categories

- **momentum**: MomentumBreakout, TrendFollowing
- **mean_reversion**: MeanReversion, FadeTheMove
- **intraday**: VWAPBounce, OpeningRangeBreakout
- **volatility**: VolatilityCompression
- **level_based**: PivotPlay

## Match Scoring

Strategies are scored based on:
1. Requirement satisfaction (70% weight)
2. Market condition alignment (30% weight)

Only strategies with match_score >= 0.5 are returned.

## Response Includes

- Current market conditions inferred from stock data
- Matching strategies sorted by score
- For each strategy:
  - Requirements met/not met
  - Recommended parameters (DTE, delta, etc.)
  - Position size modifier

## Performance Target

<300ms response time.



## OpenAPI

````yaml /api/openapi.json get /api/graph/v1/stocks/{symbol}/strategies
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/stocks/{symbol}/strategies:
    get:
      tags:
        - Stocks
      summary: Get matching trading strategies
      description: |-
        Find matching options strategies via graph traversal.

        ## Strategy Categories

        - **momentum**: MomentumBreakout, TrendFollowing
        - **mean_reversion**: MeanReversion, FadeTheMove
        - **intraday**: VWAPBounce, OpeningRangeBreakout
        - **volatility**: VolatilityCompression
        - **level_based**: PivotPlay

        ## Match Scoring

        Strategies are scored based on:
        1. Requirement satisfaction (70% weight)
        2. Market condition alignment (30% weight)

        Only strategies with match_score >= 0.5 are returned.

        ## Response Includes

        - Current market conditions inferred from stock data
        - Matching strategies sorted by score
        - For each strategy:
          - Requirements met/not met
          - Recommended parameters (DTE, delta, etc.)
          - Position size modifier

        ## Performance Target

        <300ms response time.
      operationId: get_strategies_api_graph_v1_stocks__symbol__strategies_get
      parameters:
        - name: symbol
          in: path
          required: true
          schema:
            type: string
            title: Symbol
      responses:
        '200':
          description: Strategy matches
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StrategyMatchResponse'
        '404':
          description: Stock not found
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '504':
          description: Query timeout
components:
  schemas:
    StrategyMatchResponse:
      properties:
        symbol:
          type: string
          title: Symbol
        market_conditions:
          items:
            type: string
          type: array
          title: Market Conditions
          description: Current market conditions (e.g., 'HIGH_IV', 'UPTREND', 'LOW_VIX')
        matches:
          items:
            $ref: '#/components/schemas/StrategyMatch'
          type: array
          title: Matches
          description: Matching strategies sorted by score
      type: object
      required:
        - symbol
      title: StrategyMatchResponse
      description: >-
        Options strategy recommendations based on current market conditions.


        Matches are produced by ``strategy_service.get_strategy_matches()``,
        which

        evaluates a static rule table (the ``STRATEGIES`` dict) against the
        stock's

        current indicator values and market conditions. This does NOT use the

        knowledge graph; an earlier graph-traversal design (Strategy REQUIRES /

        WORKS_IN_CONDITION edges) was specced but never implemented.
      example:
        market_conditions:
          - LOW_VIX
          - UPTREND
          - HIGH_VOLUME
        matches:
          - category: momentum
            direction: bullish
            match_score: 0.85
            parameters:
              delta_target: 0.4
              ideal_iv_rank: 30
              max_dte: 45
              min_dte: 21
              position_size_modifier: 1
            requirements_met:
              - actual: 1
                indicator: trend_stack_valid
                satisfied: true
                threshold: 1
              - actual: 1.5
                indicator: rel_volume
                satisfied: true
                threshold: 1.2
            strategy: MomentumBreakout
        symbol: AAPL
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    StrategyMatch:
      properties:
        strategy:
          type: string
          title: Strategy
          description: Strategy name (e.g., 'MomentumBreakout', 'VWAPBounce')
        category:
          type: string
          title: Category
          description: Strategy category (e.g., 'momentum', 'mean_reversion', 'volatility')
        direction:
          type: string
          title: Direction
          description: 'Bias direction: ''bullish'', ''bearish'', or ''neutral'''
        match_score:
          type: number
          maximum: 1
          minimum: 0
          title: Match Score
          description: Match quality score 0-1
        requirements_met:
          items:
            $ref: '#/components/schemas/RequirementMet'
          type: array
          title: Requirements Met
          description: Individual requirement statuses
        parameters:
          $ref: '#/components/schemas/StrategyParameters'
          description: Recommended parameters
      type: object
      required:
        - strategy
        - category
        - direction
        - match_score
        - parameters
      title: StrategyMatch
      description: Individual strategy match result.
    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
    RequirementMet:
      properties:
        indicator:
          type: string
          title: Indicator
          description: Indicator name (e.g., 'rsi_14', 'iv_percentile')
        threshold:
          type: number
          title: Threshold
          description: Required threshold value
        actual:
          type: number
          title: Actual
          description: Actual current value
        satisfied:
          type: boolean
          title: Satisfied
          description: Whether requirement is met
      type: object
      required:
        - indicator
        - threshold
        - actual
        - satisfied
      title: RequirementMet
      description: Individual strategy requirement status.
    StrategyParameters:
      properties:
        ideal_iv_rank:
          anyOf:
            - type: number
              maximum: 100
              minimum: 0
            - type: 'null'
          title: Ideal Iv Rank
          description: Ideal IV percentile for strategy
        min_dte:
          anyOf:
            - type: integer
              minimum: 0
            - type: 'null'
          title: Min Dte
          description: Minimum days to expiration
        max_dte:
          anyOf:
            - type: integer
              minimum: 0
            - type: 'null'
          title: Max Dte
          description: Maximum days to expiration
        delta_target:
          anyOf:
            - type: number
              maximum: 1
              minimum: -1
            - type: 'null'
          title: Delta Target
          description: Target delta for options position
        position_size_modifier:
          type: number
          maximum: 2
          minimum: 0.25
          title: Position Size Modifier
          description: Position size adjustment
          default: 1
      type: object
      title: StrategyParameters
      description: Recommended parameters for a strategy.

````