---
title: "Fundamentals Layer API"
description: "Company fundamentals for Saudi and GCC listed companies: reported financial statements and history, financial ratios, key highlights, analyst estimates..."
url: "https://developer.argaam.com/fundamentals-overview"
image: "https://developer.argaam.com/_og/d/c_Ocean.takumi,title_Fundamentals+Layer+API,description_~Q29tcGFueSBmdW5kYW1lbnRhbHMgZm9yIFNhdWRpIGFuZCBHQ0MgbGlzdGVkIGNvbXBhbmllczogcmVwb3J0ZWQgZmluYW5jaWFsIHN0YXRlbWVudHMgYW5kIGhpc3RvcnksIGZpbmFuY2lhbCByYXRpb3MsIGtleSBoaWdobGlnaHRzLCBhbmFseXN0IGVzdGltYXRlcy4uLg,props_eyJ0aGVtZSI6eyJtb2RlIjoibGlnaHQiLCJjb2xvcnMiOnsicHJpbWFyeSI6IiNGNTgwMjYifX19,p_Ii9mdW5kYW1lbnRhbHMtb3ZlcnZpZXci,s_KlPBCegjIh41AzhI.png"
---

Overview

[Introduction](#overview)

Companies

[Get the latest financial statements for a companyGET](#get-api-v1-1-companies-stocksymbol-financials)[Get historical financial statements for a companyGET](#get-api-v1-1-companies-stocksymbol-financials-history)[Get reports for a companyGET](#get-api-v1-1-companies-stocksymbol-financials-reports)[Get financial ratios for a companyGET](#get-api-v1-1-companies-stocksymbol-ratios)[Get historical series for a companyGET](#get-api-v1-1-companies-stocksymbol-ratios-history)[Get key financial highlights for a companyGET](#get-api-v1-1-companies-stocksymbol-highlights)[Get analyst estimates for a companyGET](#get-api-v1-1-companies-stocksymbol-estimates)[Get analyst estimates vs. actuals for a company identified by trading symbol.GET](#get-api-v1-1-companies-stocksymbol-estimates-actuals)[Get analyst opinions for a companyGET](#get-api-v1-1-companies-stocksymbol-opinions)[Get a market-level ratio by market symbolGET](#get-api-v1-1-companies-stocksymbol-ratios-market)[Get the company ranking for a metricGET](#get-api-v1-1-companies-ranking-metric)[Get the bottom 20 companies by metricGET](#get-api-v1-1-companies-ranking-metric-bottom)

Markets

[Get analyst estimates aggregated across all companies in a market.GET](#get-api-v1-1-markets-marketid-estimates)[Get aggregated financial results for all companies in a market.GET](#get-api-v1-1-markets-marketid-financials)[Get analyst buy/sell/hold opinions across companies in a market.GET](#get-api-v1-1-markets-marketid-opinions)[Get financial results for a specific company within a market.GET](#get-api-v1-1-markets-marketid-companies-stocksymbol-financials)

# Fundamentals Layer API

v1.1 CurrentOAS 3.0Production

[Plans](https://developer.argaam.com/plans)[Use this API](https://developer.argaam.com/apis/fundamentals-layer-api-production-v1/versions/9efc2daf-927c-4236-8c4b-94837efef50d)

Company fundamentals for Saudi and GCC listed companies: reported financial statements and history, financial ratios, key highlights, analyst estimates and opinions, and market-level financial results.

API base URL

https://api.argaam.com

Argaam API Gateway (Production)

Security

`ApiKeyAuth` — apikey header

`ApiKeyAuthQuery` — apikey query parameter

✉

**Additional information.** Contact Argaam IT — [developer@argaam.com](mailto:developer@argaam.com)

### [Get the latest financial statements for a company](#get-the-latest-financial-statements-for-a-company)

Returns the most recent reported income statement, balance sheet and cash-flow line items for the company. Use fiscalPeriod and year to pin a specific reporting period.

GEThttps://api.argaam.com/api/v1.1/companies/{stockSymbol}/financials

Path parameters

stockSymbolstringrequired

Tadawul stock symbol of the company, e.g. 2222 (Saudi Aramco).

Example: 2222

Query parameters

marketIdinteger (int32)

Numeric market identifier used to scope market-level data.

Default: 3 · Example: 3

periodstring

Time window for the series, e.g. 1d, 1m, 3m, 1y, 5y. Defaults to year.

Default: year · Example: year

Response

↩

**200 · application/json** — `ApiV1Response`. Every operation returns the same envelope: `success`, `apiVersion`, `timestamp`, `requestId`, `data`, `meta` and `rateLimit`. Additional properties are not allowed.

cURL

ShellCopy

```
curl --request GET \
  --url 'https://api.argaam.com/api/v1.1/companies/2222/financials?marketId=3&period=year' \
  --header 'Accept: application/json' \
  --header 'apikey: ••••••'
```

200 application/jsonCopy

```
{
  "success": true,
  "apiVersion": "1.1",
  "timestamp": "2026-08-16T09:12:44Z",
  "requestId": "b3f1c8de-4a20-4f0e-9c1a-77d2e1f0aa31",
  "data": [
    {
      "stockSymbol": "2222",
      "nameAr": "أرامكو السعودية",
      "nameEn": "Saudi Aramco"
    }
  ],
  "meta": {
    "page": 1,
    "pageSize": 20,
    "totalRecords": 1,
    "totalPages": 1,
    "hasNextPage": false,
    "hasPreviousPage": false
  },
  "rateLimit": {
    "limit": 600,
    "remaining": 597,
    "reset": "2026-08-16T09:13:00Z"
  }
}
```

### [Get historical financial statements for a company](#get-historical-financial-statements-for-a-company)

Returns the reported financial statement history for the company across fiscal periods. Use fromYear / toYear or numberOfYear to bound the range.

GEThttps://api.argaam.com/api/v1.1/companies/{stockSymbol}/financials/history

Path parameters

stockSymbolstringrequired

Tadawul stock symbol of the company, e.g. 2222 (Saudi Aramco).

Example: 2222

Query parameters

marketIdinteger (int32)

Numeric market identifier used to scope market-level data.

Default: 3 · Example: 3

periodstring

Time window for the series, e.g. 1d, 1m, 3m, 1y, 5y. Defaults to year.

Default: year · Example: year

fiscalPeriodstring

Fiscal period within the year: 1 - 4 for quarters, 5 for the full year.

Example: 5

yearinteger (int32)

Reporting or calendar year used to filter time-based data.

Example: 2023

Response

↩

**200 · application/json** — `ApiV1Response`. Every operation returns the same envelope: `success`, `apiVersion`, `timestamp`, `requestId`, `data`, `meta` and `rateLimit`. Additional properties are not allowed.

cURL

ShellCopy

```
curl --request GET \
  --url 'https://api.argaam.com/api/v1.1/companies/2222/financials/history?marketId=3&period=year&fiscalPeriod=year&year=2023' \
  --header 'Accept: application/json' \
  --header 'apikey: ••••••'
```

200 application/jsonCopy

```
{
  "success": true,
  "apiVersion": "1.1",
  "timestamp": "2026-08-16T09:12:44Z",
  "requestId": "b3f1c8de-4a20-4f0e-9c1a-77d2e1f0aa31",
  "data": [
    {
      "stockSymbol": "2222",
      "nameAr": "أرامكو السعودية",
      "nameEn": "Saudi Aramco"
    }
  ],
  "meta": {
    "page": 1,
    "pageSize": 20,
    "totalRecords": 1,
    "totalPages": 1,
    "hasNextPage": false,
    "hasPreviousPage": false
  },
  "rateLimit": {
    "limit": 600,
    "remaining": 597,
    "reset": "2026-08-16T09:13:00Z"
  }
}
```

### [Get reports for a company](#get-reports-for-a-company)

Returns the reports for the company identified by stockSymbol.

GEThttps://api.argaam.com/api/v1.1/companies/{stockSymbol}/financials/reports

Path parameters

stockSymbolstringrequired

Tadawul stock symbol of the company, e.g. 2222 (Saudi Aramco).

Example: 2222

Query parameters

marketIdinteger (int32)

Numeric market identifier used to scope market-level data.

Default: 3 · Example: 3

Response

↩

**200 · application/json** — `ApiV1Response`. Every operation returns the same envelope: `success`, `apiVersion`, `timestamp`, `requestId`, `data`, `meta` and `rateLimit`. Additional properties are not allowed.

cURL

ShellCopy

```
curl --request GET \
  --url 'https://api.argaam.com/api/v1.1/companies/2222/financials/reports?marketId=3' \
  --header 'Accept: application/json' \
  --header 'apikey: ••••••'
```

200 application/jsonCopy

```
{
  "success": true,
  "apiVersion": "1.1",
  "timestamp": "2026-08-16T09:12:44Z",
  "requestId": "b3f1c8de-4a20-4f0e-9c1a-77d2e1f0aa31",
  "data": [
    {
      "stockSymbol": "2222",
      "nameAr": "أرامكو السعودية",
      "nameEn": "Saudi Aramco"
    }
  ],
  "meta": {
    "page": 1,
    "pageSize": 20,
    "totalRecords": 1,
    "totalPages": 1,
    "hasNextPage": false,
    "hasPreviousPage": false
  },
  "rateLimit": {
    "limit": 600,
    "remaining": 597,
    "reset": "2026-08-16T09:13:00Z"
  }
}
```

### [Get financial ratios for a company](#get-financial-ratios-for-a-company)

Returns the financial ratios for the company identified by stockSymbol.

GEThttps://api.argaam.com/api/v1.1/companies/{stockSymbol}/ratios

Path parameters

stockSymbolstringrequired

Tadawul stock symbol of the company, e.g. 2222 (Saudi Aramco).

Example: 2222

Query parameters

marketIdinteger (int32)

Numeric market identifier used to scope market-level data.

Default: 3 · Example: 3

periodstring

Time window for the series, e.g. 1d, 1m, 3m, 1y, 5y. Defaults to year.

Default: year · Example: year

Response

↩

**200 · application/json** — `ApiV1Response`. Every operation returns the same envelope: `success`, `apiVersion`, `timestamp`, `requestId`, `data`, `meta` and `rateLimit`. Additional properties are not allowed.

cURL

ShellCopy

```
curl --request GET \
  --url 'https://api.argaam.com/api/v1.1/companies/2222/ratios?marketId=3&period=year' \
  --header 'Accept: application/json' \
  --header 'apikey: ••••••'
```

200 application/jsonCopy

```
{
  "success": true,
  "apiVersion": "1.1",
  "timestamp": "2026-08-16T09:12:44Z",
  "requestId": "b3f1c8de-4a20-4f0e-9c1a-77d2e1f0aa31",
  "data": [
    {
      "stockSymbol": "2222",
      "nameAr": "أرامكو السعودية",
      "nameEn": "Saudi Aramco"
    }
  ],
  "meta": {
    "page": 1,
    "pageSize": 20,
    "totalRecords": 1,
    "totalPages": 1,
    "hasNextPage": false,
    "hasPreviousPage": false
  },
  "rateLimit": {
    "limit": 600,
    "remaining": 597,
    "reset": "2026-08-16T09:13:00Z"
  }
}
```

### [Get historical series for a company](#get-historical-series-for-a-company)

Returns the historical series for the company identified by stockSymbol.

GEThttps://api.argaam.com/api/v1.1/companies/{stockSymbol}/ratios/history

Path parameters

stockSymbolstringrequired

Tadawul stock symbol of the company, e.g. 2222 (Saudi Aramco).

Example: 2222

Query parameters

marketIdinteger (int32)

Numeric market identifier used to scope market-level data.

Default: 3 · Example: 3

periodstring

Time window for the series, e.g. 1d, 1m, 3m, 1y, 5y. Defaults to year.

Default: year · Example: year

fiscalPeriodstring

Fiscal period within the year: 1 - 4 for quarters, 5 for the full year.

Example: 5

yearinteger (int32)

Reporting or calendar year used to filter time-based data.

Example: 2023

Response

↩

**200 · application/json** — `ApiV1Response`. Every operation returns the same envelope: `success`, `apiVersion`, `timestamp`, `requestId`, `data`, `meta` and `rateLimit`. Additional properties are not allowed.

cURL

ShellCopy

```
curl --request GET \
  --url 'https://api.argaam.com/api/v1.1/companies/2222/ratios/history?marketId=3&period=year&fiscalPeriod=year&year=2023' \
  --header 'Accept: application/json' \
  --header 'apikey: ••••••'
```

200 application/jsonCopy

```
{
  "success": true,
  "apiVersion": "1.1",
  "timestamp": "2026-08-16T09:12:44Z",
  "requestId": "b3f1c8de-4a20-4f0e-9c1a-77d2e1f0aa31",
  "data": [
    {
      "stockSymbol": "2222",
      "nameAr": "أرامكو السعودية",
      "nameEn": "Saudi Aramco"
    }
  ],
  "meta": {
    "page": 1,
    "pageSize": 20,
    "totalRecords": 1,
    "totalPages": 1,
    "hasNextPage": false,
    "hasPreviousPage": false
  },
  "rateLimit": {
    "limit": 600,
    "remaining": 597,
    "reset": "2026-08-16T09:13:00Z"
  }
}
```

### [Get key financial highlights for a company](#get-key-financial-highlights-for-a-company)

Returns the headline financial highlights for the company identified by stockSymbol.

GEThttps://api.argaam.com/api/v1.1/companies/{stockSymbol}/highlights

Path parameters

stockSymbolstringrequired

Tadawul stock symbol of the company, e.g. 2222 (Saudi Aramco).

Example: 2222

Query parameters

marketIdinteger (int32)

Numeric market identifier used to scope market-level data.

Default: 3 · Example: 3

periodstring

Time window for the series, e.g. 1d, 1m, 3m, 1y, 5y. Defaults to year.

Default: year · Example: year

Response

↩

**200 · application/json** — `ApiV1Response`. Every operation returns the same envelope: `success`, `apiVersion`, `timestamp`, `requestId`, `data`, `meta` and `rateLimit`. Additional properties are not allowed.

cURL

ShellCopy

```
curl --request GET \
  --url 'https://api.argaam.com/api/v1.1/companies/2222/highlights?marketId=3&period=year' \
  --header 'Accept: application/json' \
  --header 'apikey: ••••••'
```

200 application/jsonCopy

```
{
  "success": true,
  "apiVersion": "1.1",
  "timestamp": "2026-08-16T09:12:44Z",
  "requestId": "b3f1c8de-4a20-4f0e-9c1a-77d2e1f0aa31",
  "data": [
    {
      "stockSymbol": "2222",
      "nameAr": "أرامكو السعودية",
      "nameEn": "Saudi Aramco"
    }
  ],
  "meta": {
    "page": 1,
    "pageSize": 20,
    "totalRecords": 1,
    "totalPages": 1,
    "hasNextPage": false,
    "hasPreviousPage": false
  },
  "rateLimit": {
    "limit": 600,
    "remaining": 597,
    "reset": "2026-08-16T09:13:00Z"
  }
}
```

### [Get analyst estimates for a company](#get-analyst-estimates-for-a-company)

Returns forward analyst estimates for the company identified by stockSymbol.

GEThttps://api.argaam.com/api/v1.1/companies/{stockSymbol}/estimates

Path parameters

stockSymbolstringrequired

Tadawul stock symbol of the company, e.g. 2222 (Saudi Aramco).

Example: 2222

Query parameters

marketIdinteger (int32)

Numeric market identifier used to scope market-level data.

Default: 3 · Example: 3

periodstring

Time window for the series, e.g. 1d, 1m, 3m, 1y, 5y. Defaults to year.

Default: year · Example: year

Response

↩

**200 · application/json** — `ApiV1Response`. Every operation returns the same envelope: `success`, `apiVersion`, `timestamp`, `requestId`, `data`, `meta` and `rateLimit`. Additional properties are not allowed.

cURL

ShellCopy

```
curl --request GET \
  --url 'https://api.argaam.com/api/v1.1/companies/2222/estimates?marketId=3&period=year' \
  --header 'Accept: application/json' \
  --header 'apikey: ••••••'
```

200 application/jsonCopy

```
{
  "success": true,
  "apiVersion": "1.1",
  "timestamp": "2026-08-16T09:12:44Z",
  "requestId": "b3f1c8de-4a20-4f0e-9c1a-77d2e1f0aa31",
  "data": [
    {
      "stockSymbol": "2222",
      "nameAr": "أرامكو السعودية",
      "nameEn": "Saudi Aramco"
    }
  ],
  "meta": {
    "page": 1,
    "pageSize": 20,
    "totalRecords": 1,
    "totalPages": 1,
    "hasNextPage": false,
    "hasPreviousPage": false
  },
  "rateLimit": {
    "limit": 600,
    "remaining": 597,
    "reset": "2026-08-16T09:13:00Z"
  }
}
```

### [Get analyst estimates vs. actuals for a company identified by trading symbol.](#get-analyst-estimates-vs-actuals-for-a-company-identified-by-trading-symbol)

Returns analyst estimates alongside reported actuals for the company identified by stockSymbol.

GEThttps://api.argaam.com/api/v1.1/companies/{stockSymbol}/estimates/actuals

Path parameters

stockSymbolstringrequired

Tadawul stock symbol of the company, e.g. 2222 (Saudi Aramco).

Example: 2222

Query parameters

marketIdinteger (int32)

Numeric market identifier used to scope market-level data.

Default: 3 · Example: 3

yearinteger (int32)

Reporting or calendar year used to filter time-based data.

Example: 2023

fiscalPeriodstring

Fiscal period within the year: 1 - 4 for quarters, 5 for the full year.

Example: 5

Response

↩

**200 · application/json** — `ApiV1Response`. Every operation returns the same envelope: `success`, `apiVersion`, `timestamp`, `requestId`, `data`, `meta` and `rateLimit`. Additional properties are not allowed.

cURL

ShellCopy

```
curl --request GET \
  --url 'https://api.argaam.com/api/v1.1/companies/2222/estimates/actuals?marketId=3&year=2023&fiscalPeriod=year' \
  --header 'Accept: application/json' \
  --header 'apikey: ••••••'
```

200 application/jsonCopy

```
{
  "success": true,
  "apiVersion": "1.1",
  "timestamp": "2026-08-16T09:12:44Z",
  "requestId": "b3f1c8de-4a20-4f0e-9c1a-77d2e1f0aa31",
  "data": [
    {
      "stockSymbol": "2222",
      "nameAr": "أرامكو السعودية",
      "nameEn": "Saudi Aramco"
    }
  ],
  "meta": {
    "page": 1,
    "pageSize": 20,
    "totalRecords": 1,
    "totalPages": 1,
    "hasNextPage": false,
    "hasPreviousPage": false
  },
  "rateLimit": {
    "limit": 600,
    "remaining": 597,
    "reset": "2026-08-16T09:13:00Z"
  }
}
```

### [Get analyst opinions for a company](#get-analyst-opinions-for-a-company)

Returns analyst buy/sell/hold opinions for the company identified by stockSymbol.

GEThttps://api.argaam.com/api/v1.1/companies/{stockSymbol}/opinions

Path parameters

stockSymbolstringrequired

Tadawul stock symbol of the company, e.g. 2222 (Saudi Aramco).

Example: 2222

Query parameters

marketIdinteger (int32)

Numeric market identifier used to scope market-level data.

Default: 3 · Example: 3

Response

↩

**200 · application/json** — `ApiV1Response`. Every operation returns the same envelope: `success`, `apiVersion`, `timestamp`, `requestId`, `data`, `meta` and `rateLimit`. Additional properties are not allowed.

cURL

ShellCopy

```
curl --request GET \
  --url 'https://api.argaam.com/api/v1.1/companies/2222/opinions?marketId=3' \
  --header 'Accept: application/json' \
  --header 'apikey: ••••••'
```

200 application/jsonCopy

```
{
  "success": true,
  "apiVersion": "1.1",
  "timestamp": "2026-08-16T09:12:44Z",
  "requestId": "b3f1c8de-4a20-4f0e-9c1a-77d2e1f0aa31",
  "data": [
    {
      "stockSymbol": "2222",
      "nameAr": "أرامكو السعودية",
      "nameEn": "Saudi Aramco"
    }
  ],
  "meta": {
    "page": 1,
    "pageSize": 20,
    "totalRecords": 1,
    "totalPages": 1,
    "hasNextPage": false,
    "hasPreviousPage": false
  },
  "rateLimit": {
    "limit": 600,
    "remaining": 597,
    "reset": "2026-08-16T09:13:00Z"
  }
}
```

### [Get a market-level ratio by market symbol](#get-a-market-level-ratio-by-market-symbol)

Returns a market-level ratio resolved by market symbol.

GEThttps://api.argaam.com/api/v1.1/companies/{stockSymbol}/ratios/market

Path parameters

stockSymbolstringrequired

Tadawul stock symbol of the company, e.g. 2222 (Saudi Aramco).

Example: 2222

Query parameters

marketIdinteger (int32)

Numeric market identifier used to scope market-level data.

Default: 3 · Example: 3

periodstring

Time window for the series, e.g. 1d, 1m, 3m, 1y, 5y. Defaults to year.

Default: year · Example: year

Response

↩

**200 · application/json** — `ApiV1Response`. Every operation returns the same envelope: `success`, `apiVersion`, `timestamp`, `requestId`, `data`, `meta` and `rateLimit`. Additional properties are not allowed.

cURL

ShellCopy

```
curl --request GET \
  --url 'https://api.argaam.com/api/v1.1/companies/2222/ratios/market?marketId=3&period=year' \
  --header 'Accept: application/json' \
  --header 'apikey: ••••••'
```

200 application/jsonCopy

```
{
  "success": true,
  "apiVersion": "1.1",
  "timestamp": "2026-08-16T09:12:44Z",
  "requestId": "b3f1c8de-4a20-4f0e-9c1a-77d2e1f0aa31",
  "data": [
    {
      "stockSymbol": "2222",
      "nameAr": "أرامكو السعودية",
      "nameEn": "Saudi Aramco"
    }
  ],
  "meta": {
    "page": 1,
    "pageSize": 20,
    "totalRecords": 1,
    "totalPages": 1,
    "hasNextPage": false,
    "hasPreviousPage": false
  },
  "rateLimit": {
    "limit": 600,
    "remaining": 597,
    "reset": "2026-08-16T09:13:00Z"
  }
}
```

### [Get the company ranking for a metric](#get-the-company-ranking-for-a-metric)

Returns the company ranking for the requested metric. Use only supported values published in the Metrics table.

GEThttps://api.argaam.com/api/v1.1/companies/ranking/{metric}

Path parameters

metricstringrequired

Metric or ranking key. Use only supported values published in the Metrics table.

Example: pe

Query parameters

marketIdinteger (int32)

Numeric market identifier used to scope market-level data.

Default: 3 · Example: 3

periodstring

Time window for the series, e.g. 1d, 1m, 3m, 1y, 5y. Defaults to year.

Default: year · Example: year

Response

↩

**200 · application/json** — `ApiV1Response`. Every operation returns the same envelope: `success`, `apiVersion`, `timestamp`, `requestId`, `data`, `meta` and `rateLimit`. Additional properties are not allowed.

cURL

ShellCopy

```
curl --request GET \
  --url 'https://api.argaam.com/api/v1.1/companies/ranking/pe?marketId=3&period=year' \
  --header 'Accept: application/json' \
  --header 'apikey: ••••••'
```

200 application/jsonCopy

```
{
  "success": true,
  "apiVersion": "1.1",
  "timestamp": "2026-08-16T09:12:44Z",
  "requestId": "b3f1c8de-4a20-4f0e-9c1a-77d2e1f0aa31",
  "data": [
    {
      "stockSymbol": "2222",
      "nameAr": "أرامكو السعودية",
      "nameEn": "Saudi Aramco"
    }
  ],
  "meta": {
    "page": 1,
    "pageSize": 20,
    "totalRecords": 1,
    "totalPages": 1,
    "hasNextPage": false,
    "hasPreviousPage": false
  },
  "rateLimit": {
    "limit": 600,
    "remaining": 597,
    "reset": "2026-08-16T09:13:00Z"
  }
}
```

### [Get the bottom 20 companies by metric](#get-the-bottom-20-companies-by-metric)

Returns the bottom 20 companies for the requested metric.

GEThttps://api.argaam.com/api/v1.1/companies/ranking/{metric}/bottom

Path parameters

metricstringrequired

Metric or ranking key. Use only supported values published in the Metrics table.

Example: pe

Query parameters

marketIdinteger (int32)

Numeric market identifier used to scope market-level data.

Default: 3 · Example: 3

periodstring

Time window for the series, e.g. 1d, 1m, 3m, 1y, 5y. Defaults to year.

Default: year · Example: year

Response

↩

**200 · application/json** — `ApiV1Response`. Every operation returns the same envelope: `success`, `apiVersion`, `timestamp`, `requestId`, `data`, `meta` and `rateLimit`. Additional properties are not allowed.

cURL

ShellCopy

```
curl --request GET \
  --url 'https://api.argaam.com/api/v1.1/companies/ranking/pe/bottom?marketId=3&period=year' \
  --header 'Accept: application/json' \
  --header 'apikey: ••••••'
```

200 application/jsonCopy

```
{
  "success": true,
  "apiVersion": "1.1",
  "timestamp": "2026-08-16T09:12:44Z",
  "requestId": "b3f1c8de-4a20-4f0e-9c1a-77d2e1f0aa31",
  "data": [
    {
      "stockSymbol": "2222",
      "nameAr": "أرامكو السعودية",
      "nameEn": "Saudi Aramco"
    }
  ],
  "meta": {
    "page": 1,
    "pageSize": 20,
    "totalRecords": 1,
    "totalPages": 1,
    "hasNextPage": false,
    "hasPreviousPage": false
  },
  "rateLimit": {
    "limit": 600,
    "remaining": 597,
    "reset": "2026-08-16T09:13:00Z"
  }
}
```

### [Get analyst estimates aggregated across all companies in a market.](#get-analyst-estimates-aggregated-across-all-companies-in-a-market)

Returns analyst estimates aggregated across every company in the market.

GEThttps://api.argaam.com/api/v1.1/markets/{marketId}/estimates

Path parameters

marketIdinteger (int32)required

Numeric market identifier used to scope market-level data.

Default: 3 · Example: 3

Query parameters

periodstring

Time window for the series, e.g. 1d, 1m, 3m, 1y, 5y. Defaults to year.

Default: year · Example: year

yearinteger (int32)

Reporting or calendar year used to filter time-based data.

Example: 2023

Response

↩

**200 · application/json** — `ApiV1Response`. Every operation returns the same envelope: `success`, `apiVersion`, `timestamp`, `requestId`, `data`, `meta` and `rateLimit`. Additional properties are not allowed.

cURL

ShellCopy

```
curl --request GET \
  --url 'https://api.argaam.com/api/v1.1/markets/3/estimates?marketId=3&period=year&year=2023' \
  --header 'Accept: application/json' \
  --header 'apikey: ••••••'
```

200 application/jsonCopy

```
{
  "success": true,
  "apiVersion": "1.1",
  "timestamp": "2026-08-16T09:12:44Z",
  "requestId": "b3f1c8de-4a20-4f0e-9c1a-77d2e1f0aa31",
  "data": [
    {
      "stockSymbol": "2222",
      "nameAr": "أرامكو السعودية",
      "nameEn": "Saudi Aramco"
    }
  ],
  "meta": {
    "page": 1,
    "pageSize": 20,
    "totalRecords": 1,
    "totalPages": 1,
    "hasNextPage": false,
    "hasPreviousPage": false
  },
  "rateLimit": {
    "limit": 600,
    "remaining": 597,
    "reset": "2026-08-16T09:13:00Z"
  }
}
```

### [Get aggregated financial results for all companies in a market.](#get-aggregated-financial-results-for-all-companies-in-a-market)

Returns aggregated reported financial results for every company in the market.

GEThttps://api.argaam.com/api/v1.1/markets/{marketId}/financials

Path parameters

marketIdinteger (int32)required

Numeric market identifier used to scope market-level data.

Default: 3 · Example: 3

Query parameters

periodstring

Time window for the series, e.g. 1d, 1m, 3m, 1y, 5y. Defaults to year.

Default: year · Example: year

fiscalPeriodstring

Fiscal period within the year: 1 - 4 for quarters, 5 for the full year.

Example: 5

yearinteger (int32)

Reporting or calendar year used to filter time-based data.

Example: 2023

Response

↩

**200 · application/json** — `ApiV1Response`. Every operation returns the same envelope: `success`, `apiVersion`, `timestamp`, `requestId`, `data`, `meta` and `rateLimit`. Additional properties are not allowed.

cURL

ShellCopy

```
curl --request GET \
  --url 'https://api.argaam.com/api/v1.1/markets/3/financials?marketId=3&period=year&fiscalPeriod=year&year=2023' \
  --header 'Accept: application/json' \
  --header 'apikey: ••••••'
```

200 application/jsonCopy

```
{
  "success": true,
  "apiVersion": "1.1",
  "timestamp": "2026-08-16T09:12:44Z",
  "requestId": "b3f1c8de-4a20-4f0e-9c1a-77d2e1f0aa31",
  "data": [
    {
      "stockSymbol": "2222",
      "nameAr": "أرامكو السعودية",
      "nameEn": "Saudi Aramco"
    }
  ],
  "meta": {
    "page": 1,
    "pageSize": 20,
    "totalRecords": 1,
    "totalPages": 1,
    "hasNextPage": false,
    "hasPreviousPage": false
  },
  "rateLimit": {
    "limit": 600,
    "remaining": 597,
    "reset": "2026-08-16T09:13:00Z"
  }
}
```

### [Get analyst buy/sell/hold opinions across companies in a market.](#get-analyst-buysellhold-opinions-across-companies-in-a-market)

Returns the distribution of analyst opinions across companies in the market.

GEThttps://api.argaam.com/api/v1.1/markets/{marketId}/opinions

Path parameters

marketIdinteger (int32)required

Numeric market identifier used to scope market-level data.

Default: 3 · Example: 3

Query parameters

periodstring

Time window for the series, e.g. 1d, 1m, 3m, 1y, 5y. Defaults to year.

Default: year · Example: year

Response

↩

**200 · application/json** — `ApiV1Response`. Every operation returns the same envelope: `success`, `apiVersion`, `timestamp`, `requestId`, `data`, `meta` and `rateLimit`. Additional properties are not allowed.

cURL

ShellCopy

```
curl --request GET \
  --url 'https://api.argaam.com/api/v1.1/markets/3/opinions?marketId=3&period=year' \
  --header 'Accept: application/json' \
  --header 'apikey: ••••••'
```

200 application/jsonCopy

```
{
  "success": true,
  "apiVersion": "1.1",
  "timestamp": "2026-08-16T09:12:44Z",
  "requestId": "b3f1c8de-4a20-4f0e-9c1a-77d2e1f0aa31",
  "data": [
    {
      "stockSymbol": "2222",
      "nameAr": "أرامكو السعودية",
      "nameEn": "Saudi Aramco"
    }
  ],
  "meta": {
    "page": 1,
    "pageSize": 20,
    "totalRecords": 1,
    "totalPages": 1,
    "hasNextPage": false,
    "hasPreviousPage": false
  },
  "rateLimit": {
    "limit": 600,
    "remaining": 597,
    "reset": "2026-08-16T09:13:00Z"
  }
}
```

### [Get financial results for a specific company within a market.](#get-financial-results-for-a-specific-company-within-a-market)

Returns reported financial results for one company scoped to the selected market.

GEThttps://api.argaam.com/api/v1.1/markets/{marketId}/companies/{stockSymbol}/financials

Path parameters

marketIdinteger (int32)required

Numeric market identifier used to scope market-level data.

Default: 3 · Example: 3

stockSymbolstringrequired

Tadawul stock symbol of the company, e.g. 2222 (Saudi Aramco).

Example: 2222

Query parameters

periodstring

Time window for the series, e.g. 1d, 1m, 3m, 1y, 5y. Defaults to year.

Default: year · Example: year

fiscalPeriodstring

Fiscal period within the year: 1 - 4 for quarters, 5 for the full year.

Example: 5

yearinteger (int32)

Reporting or calendar year used to filter time-based data.

Example: 2023

Response

↩

**200 · application/json** — `ApiV1Response`. Every operation returns the same envelope: `success`, `apiVersion`, `timestamp`, `requestId`, `data`, `meta` and `rateLimit`. Additional properties are not allowed.

cURL

ShellCopy

```
curl --request GET \
  --url 'https://api.argaam.com/api/v1.1/markets/3/companies/2222/financials?marketId=3&period=year&fiscalPeriod=year&year=2023' \
  --header 'Accept: application/json' \
  --header 'apikey: ••••••'
```

200 application/jsonCopy

```
{
  "success": true,
  "apiVersion": "1.1",
  "timestamp": "2026-08-16T09:12:44Z",
  "requestId": "b3f1c8de-4a20-4f0e-9c1a-77d2e1f0aa31",
  "data": [
    {
      "stockSymbol": "2222",
      "nameAr": "أرامكو السعودية",
      "nameEn": "Saudi Aramco"
    }
  ],
  "meta": {
    "page": 1,
    "pageSize": 20,
    "totalRecords": 1,
    "totalPages": 1,
    "hasNextPage": false,
    "hasPreviousPage": false
  },
  "rateLimit": {
    "limit": 600,
    "remaining": 597,
    "reset": "2026-08-16T09:13:00Z"
  }
}
```