> ## 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 OHLCV chart data for a symbol

> Retrieve OHLCV candlestick data for charting.

## Intervals
- **1m**: 1-minute bars (from market_data_1min)
- **2m**: canonical 2-minute bars (server-aggregated from revision-deduplicated 1-minute bars)
- **5m**: 5-minute bars (from market_data_5min)
- **15m**: 15-minute bars (from market_data_15min_cagg)
- **30m**: 30-minute bars (aggregated on the fly from market_data_1min; hourly rollup only as emergency fallback, reported as interval=1h)
- **1h**: Hourly bars (from market_data_1hour)
- **1d**: Daily bars (from market_data_daily)

## Periods
- **1d**: Last 1 trading day
- **5d**: Last 5 trading days
- **1m**: Last 1 month
- **3m**: Last 3 months
- **6m**: Last 6 months
- **1y**: Last 1 year



## OpenAPI

````yaml /api/openapi.json get /api/graph/v1/chart/{symbol}
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/chart/{symbol}:
    get:
      tags:
        - Chart
      summary: Get OHLCV chart data for a symbol
      description: >-
        Retrieve OHLCV candlestick data for charting.


        ## Intervals

        - **1m**: 1-minute bars (from market_data_1min)

        - **2m**: canonical 2-minute bars (server-aggregated from
        revision-deduplicated 1-minute bars)

        - **5m**: 5-minute bars (from market_data_5min)

        - **15m**: 15-minute bars (from market_data_15min_cagg)

        - **30m**: 30-minute bars (aggregated on the fly from market_data_1min;
        hourly rollup only as emergency fallback, reported as interval=1h)

        - **1h**: Hourly bars (from market_data_1hour)

        - **1d**: Daily bars (from market_data_daily)


        ## Periods

        - **1d**: Last 1 trading day

        - **5d**: Last 5 trading days

        - **1m**: Last 1 month

        - **3m**: Last 3 months

        - **6m**: Last 6 months

        - **1y**: Last 1 year
      operationId: get_chart_api_graph_v1_chart__symbol__get
      parameters:
        - name: symbol
          in: path
          required: true
          schema:
            type: string
            title: Symbol
        - name: interval
          in: query
          required: false
          schema:
            enum:
              - 1m
              - 2m
              - 5m
              - 15m
              - 30m
              - 1h
              - 1d
            type: string
            description: Candle interval
            default: 5m
            title: Interval
          description: Candle interval
        - name: period
          in: query
          required: false
          schema:
            enum:
              - 1d
              - 5d
              - 1m
              - 3m
              - 6m
              - 1y
              - 5y
            type: string
            description: Time period
            default: 1d
            title: Period
          description: Time period
        - name: session
          in: query
          required: false
          schema:
            enum:
              - all
              - regular
            type: string
            description: 'Session filter: ''regular'' for RTH only'
            default: all
            title: Session
          description: 'Session filter: ''regular'' for RTH only'
        - name: warmup
          in: query
          required: false
          schema:
            type: integer
            maximum: 250
            minimum: 0
            description: Extra bars for indicator warmup
            default: 0
            title: Warmup
          description: Extra bars for indicator warmup
        - name: indicators
          in: query
          required: false
          schema:
            type: string
            description: >-
              Comma-separated indicators to compute server-side:
              ema9,ema20,sma50,sma200,vwap
            default: ''
            title: Indicators
          description: >-
            Comma-separated indicators to compute server-side:
            ema9,ema20,sma50,sma200,vwap
      responses:
        '200':
          description: Chart data retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ChartResponse'
        '404':
          description: Symbol not found or no data available
        '422':
          description: Validation error
components:
  schemas:
    ChartResponse:
      properties:
        symbol:
          type: string
          title: Symbol
          description: Stock symbol
        interval:
          type: string
          enum:
            - 1m
            - 2m
            - 5m
            - 15m
            - 30m
            - 1h
            - 1d
          title: Interval
          description: Candle interval
        period:
          type: string
          enum:
            - 1d
            - 5d
            - 1m
            - 3m
            - 6m
            - 1y
            - 5y
          title: Period
          description: Time period
        candles:
          items:
            $ref: '#/components/schemas/ChartBar'
          type: array
          title: Candles
          description: OHLCV candle data
        warmup_count:
          type: integer
          title: Warmup Count
          description: >-
            Number of leading bars that are warmup data for indicator
            computation
          default: 0
        is_lookback:
          type: boolean
          title: Is Lookback
          description: >-
            True when the requested window contained no fresh data. When True
            with an empty candles array, the underlying data is stale (see
            staleness_seconds) and was intentionally withheld rather than
            silently served.
          default: false
        last_bar_time:
          anyOf:
            - type: string
            - type: 'null'
          title: Last Bar Time
          description: ISO timestamp of the most recent bar available for the symbol
        last_source_bar_time:
          anyOf:
            - type: string
            - type: 'null'
          title: Last Source Bar Time
          description: >-
            ISO timestamp of the latest source minute included in the final
            returned candle. For rolled intraday candles this differs from
            bucket-start last_bar_time.
        staleness_seconds:
          anyOf:
            - type: integer
            - type: 'null'
          title: Staleness Seconds
          description: >-
            Seconds between now and the most recent bar available for the
            symbol. Populated whenever is_lookback is True; None for fresh
            responses.
        data_status:
          type: string
          enum:
            - ok
            - stale
            - no_data
          title: Data Status
          description: >-
            High-level data status. 'ok' = fresh bars returned. 'stale' = no
            fresh bars in the requested window, refused on fail-closed policy
            (see staleness_seconds). 'no_data' = no bars available for this
            symbol at all.
          default: ok
        source:
          type: string
          title: Source
          description: >-
            Market-data feed source label (entitlement layer). 'realtime_sip' =
            real-time SIP bars (entitled caller). 'delayed' = upper time bound
            clamped to now - 15m for non-entitled callers per SIP redistribution
            policy. 'byok' = served under the user's own Alpaca data
            entitlement.
          default: realtime_sip
      type: object
      required:
        - symbol
        - interval
        - period
        - candles
      title: ChartResponse
      description: Response model for chart data.
    ChartBar:
      properties:
        time:
          type: string
          format: date-time
          title: Time
          description: Bar timestamp (UTC)
        open:
          type: number
          title: Open
          description: Opening price
        high:
          type: number
          title: High
          description: High price
        low:
          type: number
          title: Low
          description: Low price
        close:
          type: number
          title: Close
          description: Closing price
        volume:
          type: integer
          title: Volume
          description: Trading volume
        id:
          anyOf:
            - type: string
            - type: 'null'
          title: Id
          description: Stable server bar identity
        revision:
          anyOf:
            - type: integer
              minimum: 1
            - type: 'null'
          title: Revision
          description: Monotonic aggregate revision
        interval:
          anyOf:
            - type: string
              enum:
                - 1m
                - 2m
                - 5m
            - type: 'null'
          title: Interval
          description: Exact server display interval
        finality:
          anyOf:
            - type: string
              enum:
                - forming
                - final
                - revised
            - type: 'null'
          title: Finality
          description: Server-owned aggregate finality
        source_start:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Source Start
          description: First observed source minute
        source_end:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Source End
          description: Last observed source minute
        expected_minutes:
          anyOf:
            - type: integer
              maximum: 5
              minimum: 1
            - type: 'null'
          title: Expected Minutes
        observed_minutes:
          anyOf:
            - type: integer
              maximum: 5
              minimum: 1
            - type: 'null'
          title: Observed Minutes
        completeness:
          anyOf:
            - type: string
              enum:
                - complete
                - partial
            - type: 'null'
          title: Completeness
        missing_minutes:
          anyOf:
            - items:
                type: string
                format: date-time
              type: array
            - type: 'null'
          title: Missing Minutes
        source_revision:
          anyOf:
            - type: integer
              minimum: 1
            - type: 'null'
          title: Source Revision
        ema9:
          anyOf:
            - type: number
            - type: 'null'
          title: Ema9
          description: 9-period EMA
        ema20:
          anyOf:
            - type: number
            - type: 'null'
          title: Ema20
          description: 20-period EMA
        sma50:
          anyOf:
            - type: number
            - type: 'null'
          title: Sma50
          description: 50-period SMA
        sma200:
          anyOf:
            - type: number
            - type: 'null'
          title: Sma200
          description: 200-period SMA
        vwap:
          anyOf:
            - type: number
            - type: 'null'
          title: Vwap
          description: Session VWAP
        vw:
          anyOf:
            - type: number
            - type: 'null'
          title: Vw
          description: >-
            Stored per-bar VWAP from market_data_1min (Alpaca's volume-weighted
            average price for the bar). Distinct from `vwap`, which is the
            server-computed cumulative session VWAP indicator. Intraday only;
            null when unavailable.
      type: object
      required:
        - time
        - open
        - high
        - low
        - close
        - volume
      title: ChartBar
      description: A single OHLCV candlestick bar with optional server-computed indicators.

````