Search
K
Market Data Layer API (Production)

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

Get data for a market

Returns the data for the market identified by marketSymbol.

get
https://api.argaam.com/api/v1.1/markets/{marketId}/data

Path Parameters

marketIdinteger(int32)required

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

Example:3

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/{marketId}/data
 
200 application/json

Get historical series for a market

Returns the historical series for the market identified by marketSymbol.

Bound the result with the from and to date parameters.

get
https://api.argaam.com/api/v1.1/markets/{marketId}/data/history

Query Parameters

fromstring

Start of the date range, inclusive. Format YYYY-MM-DD.

Example:2024-01-01

tostring

End of the date range, inclusive. Format YYYY-MM-DD.

Example:2024-03-31

Path Parameters

marketIdinteger(int32)required

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

Example:3

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/{marketId}/data/history
 
200 application/json