Market Data Layer API (Production)
Get the intraday price series for a company
Returns today’s intraday price points for the company, ordered oldest to newest. Intended for intraday charts; use the history endpoint for end-of-day series.
get
https://api.argaam.com/api/v1.1/companies/{stockSymbol}/price/intraday
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}/price/intraday
Authentication
Path Parameters
Query Parameters
200 application/json
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