---
title: "Get a market-level ratio by market symbol"
url: "https://developer.argaam.com/apis/fundamentals-layer-api-production-v1/versions/9efc2daf-927c-4236-8c4b-94837efef50d/operations/getCompaniesMarketRatiosByMarketId"
---

> Full API specification: https://developer.argaam.com/apis/fundamentals-layer-api-production-v1/versions/9efc2daf-927c-4236-8c4b-94837efef50d.md

# Get a market-level ratio by market symbol

`GET` `/api/v1.1/companies/market-ratios/{marketId}`

Operation ID: `getCompaniesMarketRatiosByMarketId`

Returns the market-level ratio identified by `marketSymbol`.

## Path parameters

- `marketId` (integer, int32, required) - Numeric market identifier (e.g. `1` = Tadawul / Saudi main market). Use `GET /api/v1.1/markets` to list valid values.

## Query parameters

- `fiscalPeriodTypeId` (integer, int32, optional) - Numeric fiscal period type identifier (quarterly / half-yearly / annual). Defaults to `1`.
- `excludeAramco` (integer, int32, optional) - When `true`, excludes Saudi Aramco (2222) from aggregates so a single mega-cap does not dominate market-level figures. Defaults to `0`.

## Responses

- `200` - Success

## OpenAPI definition

```yaml
openapi: 3.0.1
info:
  title: Fundamentals Layer API
  version: v1.1
servers:
  - url: https://api.argaam.com
    description: Argaam API Gateway (Production)
paths:
  /api/v1.1/companies/market-ratios/{marketId}:
    get:
      tags:
        - Companies
      parameters:
        - name: marketId
          in: path
          required: true
          schema:
            type: integer
            format: int32
          description: Numeric market identifier (e.g. `1` = Tadawul / Saudi main market).
            Use `GET /api/v1.1/markets` to list valid values.
          example: 3
        - name: fiscalPeriodTypeId
          in: query
          schema:
            type: integer
            format: int32
            default: 1
          example: 1
          description: Numeric fiscal period type identifier (quarterly / half-yearly /
            annual). Defaults to `1`.
        - name: excludeAramco
          in: query
          schema:
            type: integer
            format: int32
            default: 0
          example: 0
          description: When `true`, excludes Saudi Aramco (2222) from aggregates so a
            single mega-cap does not dominate market-level figures. Defaults to
            `0`.
      responses:
        "200":
          description: Success
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiV1Response2"
      summary: Get a market-level ratio by market symbol
      description: Returns the market-level ratio identified by `marketSymbol`.
      operationId: getCompaniesMarketRatiosByMarketId
security:
  - ApiKeyAuth: []
components:
  schemas:
    ApiV1Response2:
      type: object
      properties:
        success:
          type: boolean
          description: Always true for successful responses.
        apiVersion:
          type: string
          description: Semantic API version (e.g., "1.0.0").
          nullable: true
        timestamp:
          type: string
          description: UTC timestamp when the response was generated.
          format: date-time
        requestId:
          type: string
          description: Unique request identifier for tracing.
          nullable: true
        data:
          description: The response payload.
          nullable: true
        meta:
          $ref: "#/components/schemas/ApiV1Meta2"
        rateLimit:
          $ref: "#/components/schemas/ApiV1RateLimit2"
      additionalProperties: false
      description: Standardized successful API response wrapper for v1.0.0 endpoints.
    ApiV1Meta2:
      type: object
      properties:
        page:
          type: integer
          description: Current page number (1-based).
          format: int32
        pageSize:
          type: integer
          description: Number of items per page.
          format: int32
        totalRecords:
          type: integer
          description: Total number of records available across all pages.
          format: int32
        totalPages:
          type: integer
          description: Total number of pages.
          format: int32
          readOnly: true
        hasNextPage:
          type: boolean
          description: Whether there is a next page available.
          readOnly: true
        hasPreviousPage:
          type: boolean
          description: Whether there is a previous page available.
          readOnly: true
      additionalProperties: false
      description: Pagination and metadata information for collection responses.
    ApiV1RateLimit2:
      type: object
      properties:
        limit:
          type: integer
          description: Total request quota for the current window.
          format: int32
        remaining:
          type: integer
          description: Remaining requests in the current window.
          format: int32
        reset:
          type: string
          description: UTC timestamp when the rate limit window resets.
          format: date-time
      additionalProperties: false
      description: Rate limit information returned with each response.
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: apikey
```