Search & Discovery Layer API (Production)
List sectors
Returns the sectors available on this layer.
get
https://api.argaam.com/api/v1.1/screener/sectors
Query Parameters
marketIdinteger(int32)
Numeric market identifier (e.g. 1 = Tadawul / Saudi main market). Use GET /api/v1.1/markets to list valid values. Defaults to 3.
Default:3
Example:3
Response
200
Response
200
Success
get/api/v1.1/screener/sectors
Authentication
Query Parameters
200
Companies grouped by country, market, and sector.
Convenience lookup that returns the full universe of listed
companies organised under their country -> market -> sector
path. Often used as the seed dataset for cross-market peer
analysis.
Example
GET /api/v1.1/screener/universe?countryId=1
get
https://api.argaam.com/api/v1.1/screener/universe
Query Parameters
countryIdinteger(int32)
Country ID. Default: 1 (Saudi Arabia). Defaults to 1.
Default:1
Example:1
Response
200
Response
200
Success
get/api/v1.1/screener/universe
Authentication
Query Parameters
200
Run a screener query
Executes the URL-encoded screener query built from the structure endpoint and returns the matching companies with the requested columns. Compute-heavy: this endpoint carries its own tighter rate limit, independent of the rest of the layer.
get
https://api.argaam.com/api/v1.1/screener/run/{query}
Path Parameters
querystringrequired
URL-encoded screener query string produced by the screener structure endpoint.
Response
200
Response
200
Success
get/api/v1.1/screener/run/{query}
Authentication
Path Parameters
200
Get peer companies
Returns the peer group for the requested company - sector and size comparable listings used for relative valuation.
get
https://api.argaam.com/api/v1.1/screener/peers
Response
200
Response
200
Success
get/api/v1.1/screener/peers
Authentication
200
Get the country → markets → sectors → companies discovery tree.
Returns the full hierarchical discovery tree used to populate
cascading dropdowns in the charting tool. Each node contains
an id, name, and children array.
Tip: For a symbol-specific pre-selection use
GET /charts/universe/by-symbol?stockSymbol={symbol}.
cURL Example
curl -X GET "https://api.argaam.com/api/v1.1/charts/universe?countryId=1" \
-H "Accept: application/json"
get
https://api.argaam.com/api/v1.1/charts/universe
Query Parameters
countryIdinteger(int32)
Country ID. Default: 1 (Saudi Arabia). Defaults to 1.
Default:1
Example:1
Response
200 application/json
Response
200 application/json
Discovery tree returned.
ApiV1ResponseOfChartUniverseResponse
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.
dataobject
* Additional properties are NOT allowed.
Show Child Parameters
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/charts/universe
Authentication
Query Parameters
200 application/json