Market Data Layer API (Sandbox)
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-sandbox.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-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