countryIdinteger(int32)
Country ID. Default: 1 (Saudi Arabia). Defaults to 1.
Default:1
Example:1
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-sandbox.argaam.com/api/v1.1/charts/universe
Query Parameters
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
Get the discovery tree pre-selected to a specific trading symbol.
Convenience variant of GET /charts/universe that pre-populates the
discovery tree with the company matching the supplied ticker symbol.
Useful for deep-linking directly to a stock chart from an external page.
Tip: Use GET /companies/by-symbol/{symbol} to resolve the company ID
if you only have the ticker and need additional metadata.
get
https://api-sandbox.argaam.com/api/v1.1/charts/universe/by-symbol
Query Parameters
countryIdinteger(int32)
Country ID. Default: 1 (Saudi Arabia). Defaults to 1.
Default:1
Example:1
stockSymbolstring
Trading symbol / ticker to pre-select (e.g. 2222). Defaults to 0.
Default:0
Example:2222
Response
200 application/json
Response
200 application/json
Discovery tree with pre-selected company returned.
ApiV1ResponseOfChartUniverseBySymbolResponse
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/by-symbol
Authentication
Query Parameters
200 application/json
Unified search across companies, articles, funds, and projects
Cross-cutting free-text search across the Argaam catalog – companies, news/articles, funds, and projects – filtered by market and language, and paginated.
Example
GET /api/v1.1/search/get-search-result/aramco/3/2/All/1/10
get
https://api-sandbox.argaam.com/api/v1.1/search/get-search-result/{searchterm}/{marketid}/{languageid}/{type}/{pageno}/{limit}
Path Parameters
searchtermstringrequired
Free-text search query.
Example:aramco
marketidstringrequired
Market ID(s) to scope the search to. Use GET /api/v1.1/markets to list valid values.
Example:3
languageidinteger(int32)required
Language ID (e.g. 2 = English).
Example:2
typestringrequired
Result type filter (e.g. All, Company, Article, Fund, Project). Must be a recognized value – unrecognized values return 404.
Example:All
pagenointeger(int32)required
1-based page number.
Example:1
limitinteger(int32)required
Page size / max results to return.
Example:10
Response
200
Response
200
Success
get/api/v1.1/search/get-search-result/{searchterm}/{marketid}/{languageid}/{type}/{pageno}/{limit}
Authentication
Path Parameters
200
ArticleDetails
object * Additional properties are NOT allowed.
articleIDinteger(int32)
languageIDinteger(int32)
languagestringread-only
titlestring
bodystring
shortURLstring
publishedOnstring
articleSourceNamestring
articleTypestringread-only
articleTypeNameArstring
articleTypeNameEnstring
marketTickerIDsstring
marketTickerChartIDsarray[string]read-only
companyTickerIDsstring
companyTickerChartIDsarray[string]read-only
customAMPCssstring
Example
Article
object * Additional properties are NOT allowed.
articleIDinteger(int32)
languageIDinteger(int32)
languagestringread-only
titlestring
publishedOnstring
linkstringread-only
isLinkedboolean
linkedToURLstring
isPaidboolean
articleSourceNamestring
sourcestring
articleTypestringread-only
articleTypeNameArstring
articleTypeNameEnstring
marketTickerIDsstring
marketTickerChartIDsarray[string]read-only
companyTickerIDsstring
companyTickerChartIDsarray[string]read-only
bodystring
showDetailsboolean
iconURLstring
Example