Market Data Layer API (Sandbox)
Get stock details for a company
Returns the stock details for the company identified by stockSymbol.
get
https://api-sandbox.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-sandbox.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-sandbox.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
Get investor presentations and reports for a company
Returns investor presentations and other company reports (earnings presentations, releases, annual reports, etc.) for the company identified by stockSymbol, newest first. Each record carries both languages: descriptionEn with attachLinkUrlEn, and descriptionAr with attachLinkUrlAr.
get
https://api-sandbox.argaam.com/api/v1.1/companies/investors-presentations
Query Parameters
stockSymbolstringrequired
Tadawul stock symbol of the company, e.g. 2222 (Saudi Aramco).
Example:2222
startDatestring(date-time)
Optional. Return reports created on or after this date.
endDatestring(date-time)
Optional. Return reports created on or before this date.
reportTypeIdinteger(int32)
Optional report type filter. 1 = Earnings Call, 2 = Annual Report, 3 = Corporate Guides, 4 = Minutes of general meeting, 5 = Articles of association, 6 = Others, 7 = Real Estate Valuation Report, 8 = Coverage Reports, 9 = Investor Presentations, 10 = Earnings Call Script, 11 = Governance Policies, 12 = Roadshows Presentations, 13 = Other Reports, 14 = ESG Report, 15 = Board Report.
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/investors-presentations
Authentication
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-sandbox.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