regionstring
Region filter: all (default), domestic, or international. Defaults to all.
Default:all
Example:all
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
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
Get the canonical Argaam stock classification list (cross-market).
Returns the complete Argaam stock taxonomy, mapping each listed company
to its stock type (ordinary share, REIT, ETF, preferred share, etc.)
across all GCC exchanges.
This classification is independent of each exchange’s own sector tree
and is used as the master reference for Argaam screeners and heatmaps.
Tip: For per-company financial ratios across all classified stocks use
GET /companies/stock-classification/ratios.
For exchange-specific sector trees use
GET /markets/{marketId}/sectors.
get
https://api-sandbox.argaam.com/api/v1.1/markets/stock-classification
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/stock-classification
Authentication
200 application/json
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
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
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