> ## 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. # Screen for compression patterns > Find stocks matching compression criteria. ## Available Filters ### NR7 Filters - **min_nr7_count**: Minimum NR7 days in lookback period - **is_nr7_today**: Filter for NR7 on most recent day ### Inside Day Filters - **min_inside_day_count**: Minimum inside days in period - **is_inside_day_today**: Filter for inside day on most recent day ### Score Filters - **min_compression_score**: Minimum compression score (0-100) - **compression_level**: Filter by level (extreme/high/moderate/low/none) ### ATR Compression Filters - **max_atr_compression_ratio**: Maximum ratio (lower = more compressed) ### VCP Filters - **min_vcp_contractions**: Minimum VCP contractions ## Example Use Cases 1. **Find stocks in extreme compression:** ```json {"compression_level": "extreme"} ``` 2. **Find stocks with multiple NR7 signals:** ```json {"min_nr7_count": 3, "days": 30} ``` 3. **Find today's NR7 with high compression:** ```json {"is_nr7_today": true, "min_compression_score": 60} ``` ## Performance Target <500ms response time. ## OpenAPI ````yaml /api/openapi.json post /api/graph/v1/compression/screener 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/compression/screener: post: tags: - Compression summary: Screen for compression patterns description: >- Find stocks matching compression criteria. ## Available Filters ### NR7 Filters - **min_nr7_count**: Minimum NR7 days in lookback period - **is_nr7_today**: Filter for NR7 on most recent day ### Inside Day Filters - **min_inside_day_count**: Minimum inside days in period - **is_inside_day_today**: Filter for inside day on most recent day ### Score Filters - **min_compression_score**: Minimum compression score (0-100) - **compression_level**: Filter by level (extreme/high/moderate/low/none) ### ATR Compression Filters - **max_atr_compression_ratio**: Maximum ratio (lower = more compressed) ### VCP Filters - **min_vcp_contractions**: Minimum VCP contractions ## Example Use Cases 1. **Find stocks in extreme compression:** ```json {"compression_level": "extreme"} ``` 2. **Find stocks with multiple NR7 signals:** ```json {"min_nr7_count": 3, "days": 30} ``` 3. **Find today's NR7 with high compression:** ```json {"is_nr7_today": true, "min_compression_score": 60} ``` ## Performance Target <500ms response time. operationId: screen_compression_api_graph_v1_compression_screener_post requestBody: content: application/json: schema: $ref: '#/components/schemas/CompressionScreenerRequest' required: true responses: '200': description: Matching stocks with compression data content: application/json: schema: $ref: '#/components/schemas/CompressionScreenerResponse' '400': description: Invalid filter parameters '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' components: schemas: CompressionScreenerRequest: properties: days: type: integer maximum: 365 minimum: 1 title: Days description: Lookback period in days default: 30 min_nr7_count: type: integer minimum: 0 title: Min Nr7 Count description: Minimum NR7 count in lookback period default: 0 is_nr7_today: anyOf: - type: boolean - type: 'null' title: Is Nr7 Today description: Filter for NR7 on most recent day min_inside_day_count: type: integer minimum: 0 title: Min Inside Day Count description: Minimum inside day count in lookback period default: 0 is_inside_day_today: anyOf: - type: boolean - type: 'null' title: Is Inside Day Today description: Filter for inside day on most recent day min_compression_score: anyOf: - type: number maximum: 100 minimum: 0 - type: 'null' title: Min Compression Score description: Minimum compression score compression_level: anyOf: - $ref: '#/components/schemas/CompressionLevel' - type: 'null' description: Filter by compression level max_atr_compression_ratio: anyOf: - type: number minimum: 0 - type: 'null' title: Max Atr Compression Ratio description: Maximum ATR compression ratio (lower = more compressed) min_vcp_contractions: type: integer minimum: 0 title: Min Vcp Contractions description: Minimum VCP contraction count default: 0 limit: type: integer maximum: 500 minimum: 1 title: Limit description: Max results to return default: 100 offset: type: integer minimum: 0 title: Offset description: Results offset for pagination default: 0 type: object title: CompressionScreenerRequest description: Request parameters for compression screener. CompressionScreenerResponse: properties: results: items: $ref: '#/components/schemas/CompressionScreenerResult' type: array title: Results description: Stocks matching compression criteria total_count: type: integer title: Total Count description: Total matching stocks (before pagination) lookback_days: type: integer title: Lookback Days description: Lookback period used type: object required: - total_count - lookback_days title: CompressionScreenerResponse description: Response for compression screener endpoint. HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError CompressionLevel: type: string enum: - extreme - high - moderate - low - none title: CompressionLevel description: |- Compression level classification based on composite score. Score thresholds (aligned with confluence_scorer.go): - extreme: >= 80 - high: 60-79 - moderate: 40-59 - low: 20-39 - none: < 20 CompressionScreenerResult: properties: symbol: type: string title: Symbol description: Stock ticker symbol latest_date: type: string format: date title: Latest Date description: Most recent compression event date atr_compression_ratio: anyOf: - type: number - type: 'null' title: Atr Compression Ratio range_vs_atr_14: anyOf: - type: number - type: 'null' title: Range Vs Atr 14 bb_width_percentile: anyOf: - type: number - type: 'null' title: Bb Width Percentile compression_score: anyOf: - type: number - type: 'null' title: Compression Score compression_level: anyOf: - $ref: '#/components/schemas/CompressionLevel' - type: 'null' is_nr7: type: boolean title: Is Nr7 default: false is_inside_day: type: boolean title: Is Inside Day default: false vcp_contraction_count: type: integer title: Vcp Contraction Count default: 0 nr7_count: type: integer title: Nr7 Count description: Number of NR7 days in lookback period default: 0 inside_day_count: type: integer title: Inside Day Count description: Number of inside days in lookback period default: 0 avg_compression_ratio: anyOf: - type: number - type: 'null' title: Avg Compression Ratio description: Average compression ratio in lookback period close_price: anyOf: - type: number - type: 'null' title: Close Price volume: anyOf: - type: integer - type: 'null' title: Volume relative_volume: anyOf: - type: number - type: 'null' title: Relative Volume type: object required: - symbol - latest_date title: CompressionScreenerResult description: Single result from compression screener. 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 ````