Market Data Layer API (Production)
Get stock details for a company
Returns the stock details for the company identified by stockSymbol.
get
https://api.argaam.com/api/v1.1/companies/{stockSymbol}/stock
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
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
Authentication
Path Parameters
Query Parameters
200 application/json
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
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
Authentication
Path Parameters
Query Parameters
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
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
Authentication
Path Parameters
Query Parameters
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
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
Authentication
Query Parameters
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
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
Authentication
200 application/json