> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rangler.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Get an NGX company chart series

> Return source-free market data for an NGX company ticker or UUID.

The 1d window returns intraday observations in detailed format. The 1w window
remains daily unless interval=hourly is requested with detailed format. Longer
windows are daily. OHLCV format omits incomplete candles and reports the omission
count in the coverage block.

Requires paid access.



## OpenAPI

````yaml /openapi.json get /v1/companies/{company_ref}/chart
openapi: 3.1.0
info:
  title: Rangler API
  version: 1.0.0
  description: >-
    Customer-facing Rangler API for companies, standardized financials, filings,
    funds, market data, events, and webhooks.
servers:
  - url: https://api.rangler.co
    description: Live
  - url: https://sandbox-api.rangler.co
    description: Sandbox
security: []
tags:
  - name: Analyst estimates
    description: Consensus forecasts, revisions, contributor accuracy, and source evidence.
  - name: Analyst recommendations
    description: Analyst ratings, target-price views, and company recommendation history.
  - name: Calendar
    description: Company events and calendar exports.
  - name: Companies
    description: >-
      Company lookup, issuer details, dividends, daily trades, meeting media,
      and mentions.
  - name: Events
    description: >-
      Read earlier events and check for missed deliveries across the market, a
      company, or a fund.
  - name: Financials
    description: >-
      Standardized financial statements, reported tables, ratios, and links to
      filing sources.
  - name: Filings
    description: Filings, board changes, insider dealings, and extracted filing mentions.
  - name: Funds
    description: Fund directories, disclosures, snapshots, holdings, and performance data.
  - name: Markets
    description: Market directories and regular-session clock data.
  - name: News
    description: Company news developments and company-filtered news search.
paths:
  /v1/companies/{company_ref}/chart:
    get:
      tags:
        - Companies
      summary: Get an NGX company chart series
      description: >-
        Return source-free market data for an NGX company ticker or UUID.


        The 1d window returns intraday observations in detailed format. The 1w
        window

        remains daily unless interval=hourly is requested with detailed format.
        Longer

        windows are daily. OHLCV format omits incomplete candles and reports the
        omission

        count in the coverage block.


        Requires paid access.
      operationId: get_v1_companies_company_ref_chart
      parameters:
        - name: company_ref
          in: path
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 64
            description: NGX ticker symbol or Rangler company UUID.
            title: Company Ref
          description: NGX ticker symbol or Rangler company UUID.
        - name: period
          in: query
          required: false
          schema:
            enum:
              - 1d
              - 1w
              - 1m
              - 3m
              - ytd
              - 1y
              - all
            type: string
            description: >-
              Primary lookback window used when from is omitted. Older period
              values remain accepted for existing integrations and are listed in
              the price-chart guide.
            default: 1y
            title: Period
          description: >-
            Primary lookback window used when from is omitted. Older period
            values remain accepted for existing integrations and are listed in
            the price-chart guide.
          x-rangler-accepted-older-values:
            - 7d
            - 30d
            - 90d
            - 6m
            - 5y
            - max
        - name: from
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                format: date
              - type: 'null'
            description: Inclusive start date. Overrides period when provided.
            title: From
          description: Inclusive start date. Overrides period when provided.
        - name: to
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                format: date
              - type: 'null'
            description: Inclusive end date.
            title: To
          description: Inclusive end date.
        - name: format
          in: query
          required: false
          schema:
            enum:
              - detailed
              - line
              - ohlcv
            type: string
            description: Detailed objects, compact line points, or complete OHLCV candles.
            default: detailed
            title: Format
          description: Detailed objects, compact line points, or complete OHLCV candles.
        - name: interval
          in: query
          required: false
          schema:
            anyOf:
              - const: hourly
                type: string
              - type: 'null'
            description: >-
              Optional observation interval. Use hourly with period=1w and
              format=detailed.
            title: Interval
          description: >-
            Optional observation interval. Use hourly with period=1w and
            format=detailed.
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                oneOf:
                  - $ref: '#/components/schemas/CompanyChartDetailedResponse'
                  - $ref: '#/components/schemas/CompanyChartLineResponse'
                  - $ref: '#/components/schemas/CompanyChartOhlcvResponse'
                discriminator:
                  propertyName: format
                  mapping:
                    detailed: '#/components/schemas/CompanyChartDetailedResponse'
                    line: '#/components/schemas/CompanyChartLineResponse'
                    ohlcv: '#/components/schemas/CompanyChartOhlcvResponse'
                title: Response Get V1 Companies Company Ref Chart
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
              examples:
                default:
                  value:
                    error:
                      type: unauthorized
                      code: unauthorized
                      message: Authentication required.
                      request_id: 28fa6152-7081-492e-8a7e-00beb237b689
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
              examples:
                default:
                  value:
                    error:
                      type: forbidden
                      code: forbidden
                      message: Paid access is required.
                      request_id: 5c253b3e-778e-4a58-aaf8-07cb21e03563
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
              examples:
                default:
                  value:
                    error:
                      type: not_found
                      code: not_found
                      message: Company not found
                      request_id: 9f5237bc-7d8c-4a9d-9c1f-fbd4ef236cf9
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
              examples:
                default:
                  value:
                    error:
                      type: validation_error
                      code: validation_error
                      message: Request validation failed
                      request_id: c5964dca-d290-4465-a3dc-f92d42aa9b17
                      details:
                        - type: missing
                          loc:
                            - query
                            - ticker
                          msg: Field required
                          input: null
        '429':
          description: Too Many Requests
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
              examples:
                default:
                  value:
                    error:
                      type: rate_limit_exceeded
                      code: rate_limit_exceeded
                      message: Rate limit exceeded
                      request_id: cc4d369a-2c69-4ee2-909e-985ea35d14a9
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
              examples:
                default:
                  value:
                    error:
                      type: internal_server_error
                      code: internal_server_error
                      message: Internal Server Error
                      request_id: 70b63aba-b8a3-41c2-bb0c-fbe67d84d37d
      security:
        - RanglerApiKey: []
components:
  schemas:
    CompanyChartDetailedResponse:
      properties:
        company_id:
          type: string
          format: uuid
          title: Company Id
        asset_type:
          type: string
          enum:
            - company
            - fund
          title: Asset Type
          default: company
        symbol:
          type: string
          title: Symbol
        company_name:
          type: string
          title: Company Name
        exchange:
          anyOf:
            - type: string
            - type: 'null'
          title: Exchange
        currency:
          anyOf:
            - type: string
            - type: 'null'
          title: Currency
        period:
          anyOf:
            - type: string
              enum:
                - 1d
                - 1w
                - 1m
                - 3m
                - ytd
                - 1y
                - all
                - 7d
                - 30d
                - 90d
                - 6m
                - 5y
                - max
            - type: 'null'
          title: Period
        count:
          type: integer
          title: Count
        as_of_date:
          anyOf:
            - type: string
              format: date
            - type: 'null'
          title: As Of Date
        statistics:
          $ref: '#/components/schemas/CompanyChartStatistics'
        coverage:
          $ref: '#/components/schemas/CompanyChartCoverage'
        format:
          type: string
          const: detailed
          title: Format
          default: detailed
        data:
          items:
            $ref: '#/components/schemas/CompanyChartDetailedPoint'
          type: array
          title: Data
      type: object
      required:
        - company_id
        - symbol
        - company_name
        - count
        - statistics
        - coverage
        - data
      title: CompanyChartDetailedResponse
    CompanyChartLineResponse:
      properties:
        company_id:
          type: string
          format: uuid
          title: Company Id
        asset_type:
          type: string
          enum:
            - company
            - fund
          title: Asset Type
          default: company
        symbol:
          type: string
          title: Symbol
        company_name:
          type: string
          title: Company Name
        exchange:
          anyOf:
            - type: string
            - type: 'null'
          title: Exchange
        currency:
          anyOf:
            - type: string
            - type: 'null'
          title: Currency
        period:
          anyOf:
            - type: string
              enum:
                - 1d
                - 1w
                - 1m
                - 3m
                - ytd
                - 1y
                - all
                - 7d
                - 30d
                - 90d
                - 6m
                - 5y
                - max
            - type: 'null'
          title: Period
        count:
          type: integer
          title: Count
        as_of_date:
          anyOf:
            - type: string
              format: date
            - type: 'null'
          title: As Of Date
        statistics:
          $ref: '#/components/schemas/CompanyChartStatistics'
        coverage:
          $ref: '#/components/schemas/CompanyChartCoverage'
        format:
          type: string
          const: line
          title: Format
          default: line
        data:
          items:
            prefixItems:
              - type: string
                format: date
              - type: number
            type: array
            maxItems: 2
            minItems: 2
          type: array
          title: Data
      type: object
      required:
        - company_id
        - symbol
        - company_name
        - count
        - statistics
        - coverage
        - data
      title: CompanyChartLineResponse
    CompanyChartOhlcvResponse:
      properties:
        company_id:
          type: string
          format: uuid
          title: Company Id
        asset_type:
          type: string
          enum:
            - company
            - fund
          title: Asset Type
          default: company
        symbol:
          type: string
          title: Symbol
        company_name:
          type: string
          title: Company Name
        exchange:
          anyOf:
            - type: string
            - type: 'null'
          title: Exchange
        currency:
          anyOf:
            - type: string
            - type: 'null'
          title: Currency
        period:
          anyOf:
            - type: string
              enum:
                - 1d
                - 1w
                - 1m
                - 3m
                - ytd
                - 1y
                - all
                - 7d
                - 30d
                - 90d
                - 6m
                - 5y
                - max
            - type: 'null'
          title: Period
        count:
          type: integer
          title: Count
        as_of_date:
          anyOf:
            - type: string
              format: date
            - type: 'null'
          title: As Of Date
        statistics:
          $ref: '#/components/schemas/CompanyChartStatistics'
        coverage:
          $ref: '#/components/schemas/CompanyChartCoverage'
        format:
          type: string
          const: ohlcv
          title: Format
          default: ohlcv
        data:
          items:
            prefixItems:
              - type: string
                format: date
              - type: number
              - type: number
              - type: number
              - type: number
              - type: number
            type: array
            maxItems: 6
            minItems: 6
          type: array
          title: Data
      type: object
      required:
        - company_id
        - symbol
        - company_name
        - count
        - statistics
        - coverage
        - data
      title: CompanyChartOhlcvResponse
    ErrorEnvelope:
      type: object
      required:
        - error
      properties:
        error:
          $ref: '#/components/schemas/ErrorObject'
    CompanyChartStatistics:
      properties:
        first_close:
          anyOf:
            - type: number
            - type: 'null'
          title: First Close
        last_close:
          anyOf:
            - type: number
            - type: 'null'
          title: Last Close
        min_close:
          anyOf:
            - type: number
            - type: 'null'
          title: Min Close
        max_close:
          anyOf:
            - type: number
            - type: 'null'
          title: Max Close
        net_change:
          anyOf:
            - type: number
            - type: 'null'
          title: Net Change
        percentage_change:
          anyOf:
            - type: number
            - type: 'null'
          title: Percentage Change
          description: Fractional change across the returned range; 0.05 means 5%.
        start_date:
          anyOf:
            - type: string
              format: date
            - type: 'null'
          title: Start Date
          description: >-
            Date of the close used as this series' performance base. It may
            precede the comparison start for a sparsely traded security.
        end_date:
          anyOf:
            - type: string
              format: date
            - type: 'null'
          title: End Date
      type: object
      title: CompanyChartStatistics
    CompanyChartCoverage:
      properties:
        earliest_available_date:
          anyOf:
            - type: string
              format: date
            - type: 'null'
          title: Earliest Available Date
          description: First close available in the complete stored history.
        latest_available_date:
          anyOf:
            - type: string
              format: date
            - type: 'null'
          title: Latest Available Date
          description: Last close available in the complete stored history.
        earliest_candle_date:
          anyOf:
            - type: string
              format: date
            - type: 'null'
          title: Earliest Candle Date
          description: First complete OHLCV candle inside the requested range.
        latest_candle_date:
          anyOf:
            - type: string
              format: date
            - type: 'null'
          title: Latest Candle Date
          description: Last complete OHLCV candle inside the requested range.
        requested_start_date:
          anyOf:
            - type: string
              format: date
            - type: 'null'
          title: Requested Start Date
        requested_end_date:
          anyOf:
            - type: string
              format: date
            - type: 'null'
          title: Requested End Date
        available_points:
          type: integer
          title: Available Points
          description: Close observations in the complete stored history.
        returned_points:
          type: integer
          title: Returned Points
          description: Observations returned for the requested range and format.
        candle_ready_points:
          type: integer
          title: Candle Ready Points
        incomplete_candle_points:
          type: integer
          title: Incomplete Candle Points
        omitted_incomplete_candles:
          type: integer
          title: Omitted Incomplete Candles
        corporate_action_adjusted:
          type: boolean
          title: Corporate Action Adjusted
          description: Whether historical prices have been adjusted for corporate actions.
        frequency:
          type: string
          enum:
            - daily
            - intraday
          title: Frequency
          default: daily
        freshness:
          type: string
          enum:
            - end_of_day
            - intraday
          title: Freshness
          default: end_of_day
      type: object
      required:
        - available_points
        - returned_points
        - candle_ready_points
        - incomplete_candle_points
        - omitted_incomplete_candles
        - corporate_action_adjusted
      title: CompanyChartCoverage
    CompanyChartDetailedPoint:
      properties:
        timestamp:
          type: string
          format: date-time
          title: Timestamp
        date:
          type: string
          format: date
          title: Date
        open:
          anyOf:
            - type: number
            - type: 'null'
          title: Open
        high:
          anyOf:
            - type: number
            - type: 'null'
          title: High
        low:
          anyOf:
            - type: number
            - type: 'null'
          title: Low
        close:
          type: number
          title: Close
        volume:
          anyOf:
            - type: number
            - type: 'null'
          title: Volume
        value_traded:
          anyOf:
            - type: number
            - type: 'null'
          title: Value Traded
        vwap:
          anyOf:
            - type: number
            - type: 'null'
          title: Vwap
        trade_count:
          anyOf:
            - type: number
            - type: 'null'
          title: Trade Count
        change:
          anyOf:
            - type: number
            - type: 'null'
          title: Change
        percentage_change:
          anyOf:
            - type: number
            - type: 'null'
          title: Percentage Change
          description: Fractional daily change; 0.05 means 5%.
        candle_ready:
          type: boolean
          title: Candle Ready
      type: object
      required:
        - timestamp
        - date
        - close
        - candle_ready
      title: CompanyChartDetailedPoint
    ErrorObject:
      type: object
      required:
        - type
        - code
        - message
        - request_id
      properties:
        type:
          type: string
        code:
          type: string
        message:
          type: string
        request_id:
          type: string
        details:
          anyOf:
            - additionalProperties: true
              type: object
            - type: array
              items:
                additionalProperties: true
                type: object
            - type: 'null'
  securitySchemes:
    RanglerApiKey:
      type: apiKey
      in: header
      name: X-API-Key

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.