Search
K
Market Data Layer API (Production)

Get summary for a company

Returns the summary for the company identified by stockSymbol.

get
https://api.argaam.com/api/v1.1/companies/{stockSymbol}/stock/summary

Query Parameters

marketIdinteger(int32)

Numeric market identifier (e.g. 1 = Tadawul / Saudi main market). Use GET /api/v1.1/markets to list valid values.

Default:3

Example:3

Path Parameters

stockSymbolstringrequired

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

Example:2222

Response

200 application/json

Success

ApiV1Response

* Additional properties are NOT allowed.
successboolean
apiVersionstring | null
timestampstring(date-time)
requestIdstring | null
data
metaobject
* Additional properties are NOT allowed.
Show Child Parameters
rateLimitobject
* Additional properties are NOT allowed.
Show Child Parameters
get/api/v1.1/companies/{stockSymbol}/stock/summary
 
200 application/json

Get the Argaam sector classification for a company.

Returns the company’s position in the Argaam industry taxonomy:
sector, sub-sector, and industry group (Arabic + English names).

The Argaam classification is independent of the exchange’s own
sector tree and follows GICS-inspired groupings optimized for
GCC markets.

Tip: For a cross-market sector roster use
GET /markets/stock-classification.

get
https://api.argaam.com/api/v1.1/companies/{stockSymbol}/sector

Query Parameters

marketIdstring

Numeric market identifier (e.g. 1 = Tadawul / Saudi main market). Use GET /api/v1.1/markets to list valid values.

Default:3

Example:3

Path Parameters

stockSymbolstringrequired

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

Example:2222

Response

200 application/json

Success

ApiV1Response

* Additional properties are NOT allowed.
successboolean
apiVersionstring | null
timestampstring(date-time)
requestIdstring | null
data
metaobject
* Additional properties are NOT allowed.
Show Child Parameters
rateLimitobject
* Additional properties are NOT allowed.
Show Child Parameters
get/api/v1.1/companies/{stockSymbol}/sector
 
200 application/json

List all markets (domestic and/or international).

Returns the Argaam market catalogue, optionally filtered by region.

Region values

Value Description
all (default) Both domestic GCC markets and international indices
domestic GCC exchange list only (Tadawul, DFM, ADX, MSM, etc.)
international International indices only (NYSE, LSE, Nikkei, etc.)

Domestic markets include the numeric MarketID used across all other
Markets and Companies endpoints (e.g. marketId=1 = Saudi Tadawul).

Tip: Use marketId=3 to request consolidated cross-GCC data in other
endpoints — it represents the combined GCC view.

get
https://api.argaam.com/api/v1.1/markets

Query Parameters

regionstring

Region filter: all (default), domestic, or international. Defaults to all.

Default:all

Example:all

Response

200 application/json

Success

ApiV1Response

* Additional properties are NOT allowed.
successboolean
apiVersionstring | null
timestampstring(date-time)
requestIdstring | null
data
metaobject
* Additional properties are NOT allowed.
Show Child Parameters
rateLimitobject
* Additional properties are NOT allowed.
Show Child Parameters
get/api/v1.1/markets
 
200 application/json

Get the canonical Argaam stock classification list (cross-market).

Returns the complete Argaam stock taxonomy, mapping each listed company
to its stock type (ordinary share, REIT, ETF, preferred share, etc.)
across all GCC exchanges.

This classification is independent of each exchange’s own sector tree
and is used as the master reference for Argaam screeners and heatmaps.

Tip: For per-company financial ratios across all classified stocks use
GET /companies/stock-classification/ratios.
For exchange-specific sector trees use
GET /markets/{marketId}/sectors.

get
https://api.argaam.com/api/v1.1/markets/stock-classification

Response

200 application/json

Success

ApiV1Response

* Additional properties are NOT allowed.
successboolean
apiVersionstring | null
timestampstring(date-time)
requestIdstring | null
data
metaobject
* Additional properties are NOT allowed.
Show Child Parameters
rateLimitobject
* Additional properties are NOT allowed.
Show Child Parameters
get/api/v1.1/markets/stock-classification
 
200 application/json

List companies across all markets (cross-market, paged).

Returns a flat list of all companies across every GCC exchange in
the Argaam database, optionally personalized with watchlist data for
a logged-in user.

Language codes — 1 = English (default), 2 = Arabic.

Tip: To restrict to a single exchange use
GET /markets/{marketId}/companies. For searchable/pageable listing
use GET /companies?marketIds={ids}.

get
https://api.argaam.com/api/v1.1/markets/all/companies

Query Parameters

langinteger(int32)

Language ID: 1 = English (default), 2 = Arabic. Defaults to 1.

Default:1

Example:1

userIdinteger(int32)

Optional user ID for personalized watchlist data. Default: 0. Defaults to 0.

Default:0

Example:0

Response

200 application/json

Success

ApiV1Response2

Standardized successful API response wrapper for v1.0.0 endpoints.

* Additional properties are NOT allowed.
successboolean

Always true for successful responses.

apiVersionstring | null

Semantic API version (e.g., “1.0.0”).

timestampstring(date-time)

UTC timestamp when the response was generated.

requestIdstring | null

Unique request identifier for tracing.

data

The response payload.

metaobject

Pagination and metadata information for collection responses.

* Additional properties are NOT allowed.
Show Child Parameters
rateLimitobject

Rate limit information returned with each response.

* Additional properties are NOT allowed.
Show Child Parameters
get/api/v1.1/markets/all/companies
 
200 application/json