> ## 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 price events for a stock > Get price events detected by the Go pattern-detector for a specific stock. ## Event Categories ### Gap Events - `gap_up`: Gap up > 1% from prior close - `gap_down`: Gap down < -1% from prior close ### Breakout Events - `breakout_52w_high`: New 52-week high - `breakout_52w_low`: New 52-week low - `breakout_ib_high`: Initial balance high breakout (after 10:30 ET) - `breakout_ib_low`: Initial balance low breakdown (after 10:30 ET) - `breakout_vwap`: VWAP cross - `breakout_poc`: Point of control cross - `breakout_pivot_r1`: R1 pivot breakout - `breakout_pivot_s1`: S1 pivot breakdown ### MA Crossover Events - `golden_cross`: SMA50 crosses above SMA200 - `death_cross`: SMA50 crosses below SMA200 - `ema_cross_bullish`: EMA9 crosses above EMA20 - `ema_cross_bearish`: EMA9 crosses below EMA20 ### Volume Events - `volume_spike`: RVOL >= 3.0 - `volume_climax`: RVOL >= 3.0 with significant price move - `volume_dry_up`: RVOL <= 0.3 ### Range Events - `range_expansion`: Range > 2x ATR(14) - `range_compression`: Range < 0.5x ATR(14) - `inside_day`: Bar range contained within prior bar - `outside_day`: Bar range exceeds prior bar in both directions - `nr7_day`: Narrowest range of last 7 days ### Pattern Events - `vcp_breakout`: Volatility contraction pattern breakout - `flag_breakout`: Bull/bear flag breakout - `triangle_breakout`: Triangle pattern breakout ## Severity Levels - `low`: Minor event - `medium`: Normal significance - `high`: Important event - `critical`: Highly significant event ## Query Parameters - **days**: Number of days to look back (default 30, max 90) - **event_types**: Comma-separated list of event types to filter - **min_severity**: Minimum severity level (low, medium, high, critical) ## Performance Target <100ms response time. ## OpenAPI ````yaml /api/openapi.json get /api/graph/v1/stocks/{symbol}/price-events 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}/price-events: get: tags: - Stocks summary: Get price events for a stock description: >- Get price events detected by the Go pattern-detector for a specific stock. ## Event Categories ### Gap Events - `gap_up`: Gap up > 1% from prior close - `gap_down`: Gap down < -1% from prior close ### Breakout Events - `breakout_52w_high`: New 52-week high - `breakout_52w_low`: New 52-week low - `breakout_ib_high`: Initial balance high breakout (after 10:30 ET) - `breakout_ib_low`: Initial balance low breakdown (after 10:30 ET) - `breakout_vwap`: VWAP cross - `breakout_poc`: Point of control cross - `breakout_pivot_r1`: R1 pivot breakout - `breakout_pivot_s1`: S1 pivot breakdown ### MA Crossover Events - `golden_cross`: SMA50 crosses above SMA200 - `death_cross`: SMA50 crosses below SMA200 - `ema_cross_bullish`: EMA9 crosses above EMA20 - `ema_cross_bearish`: EMA9 crosses below EMA20 ### Volume Events - `volume_spike`: RVOL >= 3.0 - `volume_climax`: RVOL >= 3.0 with significant price move - `volume_dry_up`: RVOL <= 0.3 ### Range Events - `range_expansion`: Range > 2x ATR(14) - `range_compression`: Range < 0.5x ATR(14) - `inside_day`: Bar range contained within prior bar - `outside_day`: Bar range exceeds prior bar in both directions - `nr7_day`: Narrowest range of last 7 days ### Pattern Events - `vcp_breakout`: Volatility contraction pattern breakout - `flag_breakout`: Bull/bear flag breakout - `triangle_breakout`: Triangle pattern breakout ## Severity Levels - `low`: Minor event - `medium`: Normal significance - `high`: Important event - `critical`: Highly significant event ## Query Parameters - **days**: Number of days to look back (default 30, max 90) - **event_types**: Comma-separated list of event types to filter - **min_severity**: Minimum severity level (low, medium, high, critical) ## Performance Target <100ms response time. operationId: get_stock_price_events_api_graph_v1_stocks__symbol__price_events_get parameters: - name: symbol in: path required: true schema: type: string title: Symbol - name: days in: query required: false schema: type: integer maximum: 90 minimum: 1 description: Number of days to look back default: 30 title: Days description: Number of days to look back - name: event_types in: query required: false schema: anyOf: - type: string - type: 'null' description: >- Comma-separated event types to filter (e.g., gap_up,gap_down,golden_cross) title: Event Types description: >- Comma-separated event types to filter (e.g., gap_up,gap_down,golden_cross) - name: min_severity in: query required: false schema: anyOf: - type: string - type: 'null' description: 'Minimum severity: low, medium, high, critical' title: Min Severity description: 'Minimum severity: low, medium, high, critical' responses: '200': description: List of price events content: application/json: schema: type: array items: $ref: '#/components/schemas/PriceEvent' title: >- Response Get Stock Price Events Api Graph V1 Stocks Symbol Price Events Get '404': description: Stock not found '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' '504': description: Query timeout components: schemas: PriceEvent: properties: event_id: type: string title: Event Id description: 'Unique ID: {symbol}_{type}_{YYYYMMDD_HHMMSS}_{hash6}' event_type: type: string title: Event Type description: Event type (gap_up, gap_down, breakout_52w_high, golden_cross, etc.) event_date: type: string format: date-time title: Event Date description: Bar timestamp when event was detected severity: type: string title: Severity description: 'Event severity: low, medium, high, critical' magnitude: anyOf: - type: number - type: 'null' title: Magnitude description: Percentage change or ratio for the event reference_price: anyOf: - type: number - type: 'null' title: Reference Price description: Prior price used for comparison trigger_price: anyOf: - type: number - type: 'null' title: Trigger Price description: Price that triggered the event level_name: anyOf: - type: string - type: 'null' title: Level Name description: Level crossed (52w_high, ib_low, vwap, etc.) level_value: anyOf: - type: number - type: 'null' title: Level Value description: Value of the level that was crossed rel_volume: anyOf: - type: number - type: 'null' title: Rel Volume description: Relative volume at time of event atr_ratio: anyOf: - type: number - type: 'null' title: Atr Ratio description: Move size relative to ATR(14) details: anyOf: - type: string - type: 'null' title: Details description: Human-readable event description type: object required: - event_id - event_type - event_date - severity title: PriceEvent description: >- Price event detected by Go pattern-detector. Events include gaps, breakouts, MA crossovers, volume events, and pattern triggers. All 28 event types are edge-triggered (detect crosses, not just state). 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 ````