Market Data Layer API (Production)
Get the historical price series for a company
Returns end-of-day OHLC price history for the company. Bound the result with from/to or period - unbounded calls return the full available history and are heavily rate limited.
Bound the result with the from and to date parameters.
get
https://api.argaam.com/api/v1.1/companies/{stockSymbol}/price/history
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
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
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}/price/history
Authentication
Path Parameters
Query Parameters
200 application/json
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