---
title: "Get analyst estimates aggregated across all companies in a market."
url: "https://developer.argaam.com/apis/fundamentals-layer-api-production-v1/versions/9efc2daf-927c-4236-8c4b-94837efef50d/operations/getMarketsByMarketIdAnalystEstimates"
---

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

# Get analyst estimates aggregated across all companies in a market.

`GET` `/api/v1.1/markets/{marketId}/analyst-estimates`

Operation ID: `getMarketsByMarketIdAnalystEstimates`

Returns consensus analyst estimates for a specific financial statement field across all coverage companies in the market for the given fiscal year and period. **Common `fsFieldId` values** | ID | Field | |---|---| | `54` (default) | Net Income | | `1` | Revenue | | `3` | Operating Income | | `8` | EPS | **Period values** — `year` (default), `quarter`, `interim`. **Tip:** For a single company's estimates use `GET /companies/{companyId}/analyst-estimates`.

## Path parameters

- `marketId` (integer, int32, required) - Market ID (e.g. `1` for Saudi Tadawul).

## Query parameters

- `year` (integer, int32, optional) - Fiscal year (e.g. `2024`).
- `period` (string, optional) - Fiscal period type: `year` (default), `quarter`, or `interim`. Defaults to `year`.
- `fiscalPeriod` (string, optional) - Specific sub-period: `year`, `q1`–`q4`, `i1`–`i3`. Defaults to the period type's natural value.
- `fsFieldId` (integer, int32, optional) - Financial statement field ID. Default `54` (Net Income). Defaults to `54`.

## 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/markets/{marketId}/analyst-estimates:
    get:
      tags:
        - Markets
      parameters:
        - name: marketId
          in: path
          required: true
          schema:
            type: integer
            format: int32
          description: Market ID (e.g. `1` for Saudi Tadawul).
          example: 3
        - name: year
          in: query
          description: Fiscal year (e.g. `2024`).
          schema:
            type: integer
            format: int32
          example: 2023
        - name: period
          in: query
          description: "Fiscal period type: `year` (default), `quarter`, or `interim`.
            Defaults to `year`."
          schema:
            type: string
            default: year
          example: year
        - name: fiscalPeriod
          in: query
          description: "Specific sub-period: `year`, `q1`–`q4`, `i1`–`i3`. Defaults to the
            period type's natural value."
          schema:
            type: string
            default: ""
          example: year
        - name: fsFieldId
          in: query
          description: Financial statement field ID. Default `54` (Net Income). Defaults
            to `54`.
          schema:
            type: integer
            format: int32
            default: 54
          example: 54
      responses:
        "200":
          description: Success
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiV1Response"
      summary: Get analyst estimates aggregated across all companies in a market.
      description: "Returns consensus analyst estimates for a specific financial
        statement\r

        field across all coverage companies in the market for the given fiscal\r

        year and period.\r

        \                  \r

        **Common `fsFieldId` values**\r

        | ID | Field |\r

        |---|---|\r

        | `54` (default) | Net Income |\r

        | `1`  | Revenue |\r

        | `3`  | Operating Income |\r

        | `8`  | EPS |\r

        \            \r

        **Period values** — `year` (default), `quarter`, `interim`.\r

        \            \r

        **Tip:** For a single company's estimates use\r

        `GET /companies/{companyId}/analyst-estimates`."
      operationId: getMarketsByMarketIdAnalystEstimates
security:
  - ApiKeyAuth: []
components:
  schemas:
    ApiV1Response:
      type: object
      properties:
        success:
          type: boolean
        apiVersion:
          type: string
          nullable: true
        timestamp:
          type: string
          format: date-time
        requestId:
          type: string
          nullable: true
        data:
          nullable: true
        meta:
          $ref: "#/components/schemas/ApiV1Meta"
        rateLimit:
          $ref: "#/components/schemas/ApiV1RateLimit"
      additionalProperties: false
    ApiV1Meta:
      type: object
      properties:
        page:
          type: integer
          format: int32
        pageSize:
          type: integer
          format: int32
        totalRecords:
          type: integer
          format: int32
        totalPages:
          type: integer
          format: int32
          readOnly: true
        hasNextPage:
          type: boolean
          readOnly: true
        hasPreviousPage:
          type: boolean
          readOnly: true
      additionalProperties: false
    ApiV1RateLimit:
      type: object
      properties:
        limit:
          type: integer
          format: int32
        remaining:
          type: integer
          format: int32
        reset:
          type: string
          format: date-time
      additionalProperties: false
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: apikey
```