> ## 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 compact NGX equity snapshots

> Return one current end-of-day market and valuation snapshot per NGX equity. Omit `tickers` to return all supported equities, or repeat `tickers` to select symbols. Unavailable or unresolved metrics are returned as `null`.

Requires paid access.



## OpenAPI

````yaml /openapi.json get /v1/market-data/equities
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/market-data/equities:
    get:
      tags:
        - Markets
      summary: Get compact NGX equity snapshots
      description: >-
        Return one current end-of-day market and valuation snapshot per NGX
        equity. Omit `tickers` to return all supported equities, or repeat
        `tickers` to select symbols. Unavailable or unresolved metrics are
        returned as `null`.


        Requires paid access.
      operationId: get_v1_market-data_equities
      parameters:
        - name: tickers
          in: query
          required: false
          schema:
            anyOf:
              - type: array
                items:
                  type: string
                  minLength: 1
                  maxLength: 32
                  pattern: ^[A-Za-z0-9][A-Za-z0-9._-]*$
                maxItems: 100
              - type: 'null'
            description: >-
              Optional NGX ticker filter. Repeat `tickers` to request multiple
              symbols.
            examples:
              - - ETI
                - ARADEL
            title: Tickers
          description: >-
            Optional NGX ticker filter. Repeat `tickers` to request multiple
            symbols.
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EquitySnapshotsRead'
        '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
        '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:
    EquitySnapshotsRead:
      properties:
        count:
          type: integer
          title: Count
          description: Number of equity snapshots returned.
        data:
          items:
            $ref: '#/components/schemas/EquitySnapshotRead'
          type: array
          title: Data
          description: Current snapshots ordered by ticker.
      type: object
      required:
        - count
        - data
      title: EquitySnapshotsRead
    ErrorEnvelope:
      type: object
      required:
        - error
      properties:
        error:
          $ref: '#/components/schemas/ErrorObject'
    EquitySnapshotRead:
      properties:
        ticker:
          type: string
          title: Ticker
          description: NGX trading symbol.
        name:
          type: string
          title: Name
          description: Listed company name.
        sector:
          anyOf:
            - type: string
            - type: 'null'
          title: Sector
          description: NGX sector classification when available.
        market:
          type: string
          title: Market
          description: Market code for the listing.
        currency:
          type: string
          title: Currency
          description: ISO 4217 currency of the price fields.
        as_of_date:
          anyOf:
            - type: string
              format: date
            - type: 'null'
          title: As Of Date
          description: Trading date represented by the price fields.
        open:
          anyOf:
            - type: number
            - type: 'null'
          title: Open
          description: Opening price on `as_of_date`.
        high:
          anyOf:
            - type: number
            - type: 'null'
          title: High
          description: Highest price on `as_of_date`.
        low:
          anyOf:
            - type: number
            - type: 'null'
          title: Low
          description: Lowest price on `as_of_date`.
        close:
          anyOf:
            - type: number
            - type: 'null'
          title: Close
          description: Closing price on `as_of_date`.
        previous_close:
          anyOf:
            - type: number
            - type: 'null'
          title: Previous Close
          description: Previous available closing price.
        change:
          anyOf:
            - type: number
            - type: 'null'
          title: Change
          description: Price change from `previous_close` to `close`.
        percentage_change:
          anyOf:
            - type: number
            - type: 'null'
          title: Percentage Change
          description: Percentage price change, where 1.5 means 1.5%.
        volume:
          anyOf:
            - type: number
            - type: 'null'
          title: Volume
          description: Reported trading volume on `as_of_date`.
        average_volume_30d:
          anyOf:
            - type: number
            - type: 'null'
          title: Average Volume 30D
          description: Mean reported volume over the latest 30 trading sessions.
        week_52_low:
          anyOf:
            - type: number
            - type: 'null'
          title: Week 52 Low
          description: Lowest valid price in the trailing 52 weeks.
        week_52_high:
          anyOf:
            - type: number
            - type: 'null'
          title: Week 52 High
          description: Highest valid price in the trailing 52 weeks.
        market_cap:
          anyOf:
            - type: number
            - type: 'null'
          title: Market Cap
          description: Market capitalization in `market_cap_currency`.
        market_cap_currency:
          anyOf:
            - type: string
            - type: 'null'
          title: Market Cap Currency
          description: ISO 4217 currency of `market_cap`.
        eps_ttm:
          anyOf:
            - type: number
            - type: 'null'
          title: Eps Ttm
          description: Earnings per share for the trailing twelve months.
        eps_currency:
          anyOf:
            - type: string
            - type: 'null'
          title: Eps Currency
          description: ISO 4217 currency of `eps_ttm`.
        fundamentals_as_of_date:
          anyOf:
            - type: string
              format: date
            - type: 'null'
          title: Fundamentals As Of Date
          description: Latest financial period used for EPS and P/E metrics.
        pe_ratio_ttm:
          anyOf:
            - type: number
            - type: 'null'
          title: Pe Ratio Ttm
          description: Price-to-earnings ratio using trailing EPS.
        dividend_yield_ttm_pct:
          anyOf:
            - type: number
            - type: 'null'
          title: Dividend Yield Ttm Pct
          description: Trailing dividend yield as a percentage; 3.08 means 3.08%.
      type: object
      required:
        - ticker
        - name
        - sector
        - market
        - currency
        - as_of_date
        - open
        - high
        - low
        - close
        - previous_close
        - change
        - percentage_change
        - volume
        - average_volume_30d
        - week_52_low
        - week_52_high
        - market_cap
        - market_cap_currency
        - eps_ttm
        - eps_currency
        - fundamentals_as_of_date
        - pe_ratio_ttm
        - dividend_yield_ttm_pct
      title: EquitySnapshotRead
    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.