Market Data Layer API (Sandbox)

Market Data Layer API

Get investor presentations and reports for a company

Returns investor presentations and other company reports (earnings presentations, releases, annual reports, etc.) for the company identified by stockSymbol, newest first. Each record carries both languages: descriptionEn with attachLinkUrlEn, and descriptionAr with attachLinkUrlAr.

get
https://api-sandbox.argaam.com/api/v1.1/companies/investors-presentations

Query Parameters

stockSymbolstringrequired

Tadawul stock symbol of the company, e.g. 2222 (Saudi Aramco).

Example:2222

startDatestring(date-time)

Optional. Return reports created on or after this date.

endDatestring(date-time)

Optional. Return reports created on or before this date.

reportTypeIdinteger(int32)

Optional report type filter. 1 = Earnings Call, 2 = Annual Report, 3 = Corporate Guides, 4 = Minutes of general meeting, 5 = Articles of association, 6 = Others, 7 = Real Estate Valuation Report, 8 = Coverage Reports, 9 = Investor Presentations, 10 = Earnings Call Script, 11 = Governance Policies, 12 = Roadshows Presentations, 13 = Other Reports, 14 = ESG Report, 15 = Board Report.

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/companies/investors-presentations
 
200 application/json

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

regionstring

Region filter: all (default), domestic, or international. Defaults to all.

Default:all

Example:all

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
 
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

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
 
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

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
 
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

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
 
200 application/json