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.
Success
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}.
Language ID: 1 = English (default), 2 = Arabic. Defaults to 1.
Default:1
Example:1
Optional user ID for personalized watchlist data. Default: 0. Defaults to 0.
Default:0
Example:0
Success
Standardized successful API response wrapper for v1.0.0 endpoints.
Always true for successful responses.
Semantic API version (e.g., “1.0.0”).
UTC timestamp when the response was generated.
Unique request identifier for tracing.
The response payload.
Pagination and metadata information for collection responses.
Rate limit information returned with each response.
Returns the data for the market identified by marketSymbol.
Numeric market identifier (e.g. 1 = Tadawul / Saudi main market). Use GET /api/v1.1/markets to list valid values.
Example:3
Success
Returns the historical series for the market identified by marketSymbol.
Bound the result with the from and to date parameters.
Start of the date range, inclusive. Format YYYY-MM-DD.
Example:2024-01-01
End of the date range, inclusive. Format YYYY-MM-DD.
Example:2024-03-31
Numeric market identifier (e.g. 1 = Tadawul / Saudi main market). Use GET /api/v1.1/markets to list valid values.
Example:3
Success
Returns the companies for the market identified by marketSymbol.
Numeric market identifier (e.g. 1 = Tadawul / Saudi main market). Use GET /api/v1.1/markets to list valid values.
Example:3
Success