langinteger(int32)
Language ID: 1 = English (default), 2 = Arabic. Defaults to 1.
Default:1
Example:1
userIdinteger(int32)
Optional user ID for personalized watchlist data. Default: 0. Defaults to 0.
Default:0
Example:0
List companies across all markets (cross-market, paged).
Returns a flat list of all companies across every GCC exchange in
the Argaam database, optionally personalized with watchlist data for
a logged-in user.
Language codes — 1 = English (default), 2 = Arabic.
Tip: To restrict to a single exchange use
GET /markets/{marketId}/companies. For searchable/pageable listing
use GET /companies?marketIds={ids}.
get
https://api-sandbox.argaam.com/api/v1.1/markets/all/companies
Query Parameters
Response
200 application/json
Response
200 application/json
Success
ApiV1Response2
Standardized successful API response wrapper for v1.0.0 endpoints.
* Additional properties are NOT allowed.
successboolean
Always true for successful responses.
apiVersionstring | null
Semantic API version (e.g., “1.0.0”).
timestampstring(date-time)
UTC timestamp when the response was generated.
requestIdstring | null
Unique request identifier for tracing.
data
The response payload.
metaobject
Pagination and metadata information for collection responses.
* Additional properties are NOT allowed.
Show Child Parameters
rateLimitobject
Rate limit information returned with each response.
* Additional properties are NOT allowed.
Show Child Parameters
get/api/v1.1/markets/all/companies
Authentication
Query Parameters
200 application/json
Get data for a market
Returns the data for the market identified by marketSymbol.
get
https://api-sandbox.argaam.com/api/v1.1/markets/{marketId}/data
Path Parameters
marketIdinteger(int32)required
Numeric market identifier (e.g. 1 = Tadawul / Saudi main market). Use GET /api/v1.1/markets to list valid values.
Example:3
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/{marketId}/data
Authentication
Path Parameters
200 application/json
Get historical series for a market
Returns the historical series for the market identified by marketSymbol.
Bound the result with the from and to date parameters.
get
https://api-sandbox.argaam.com/api/v1.1/markets/{marketId}/data/history
Query Parameters
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
marketIdinteger(int32)required
Numeric market identifier (e.g. 1 = Tadawul / Saudi main market). Use GET /api/v1.1/markets to list valid values.
Example:3
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/{marketId}/data/history
Authentication
Path Parameters
Query Parameters
200 application/json
Get companies for a market
Returns the companies for the market identified by marketSymbol.
get
https://api-sandbox.argaam.com/api/v1.1/markets/{marketId}/companies
Path Parameters
marketIdinteger(int32)required
Numeric market identifier (e.g. 1 = Tadawul / Saudi main market). Use GET /api/v1.1/markets to list valid values.
Example:3
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/{marketId}/companies
Authentication
Path Parameters
200 application/json
Get data for a international
Returns the data for the international identified by marketSymbol.
get
https://api-sandbox.argaam.com/api/v1.1/markets/international/{marketId}/data
Path Parameters
marketIdinteger(int32)required
Numeric market identifier (e.g. 1 = Tadawul / Saudi main market). Use GET /api/v1.1/markets to list valid values.
Example:3
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/international/{marketId}/data
Authentication
Path Parameters
200 application/json