pageinteger(int32)
Page number (1-based). Default: 1. Defaults to 1.
Default:1
Example:1
recordsinteger(int32)
Records per page. Default: 10. Defaults to 10.
Default:10
Example:10
Get analyst buy/sell/hold opinions across companies in a market.
Returns paginated analyst opinion records for all covered companies
in the specified market. Each record includes the analyst firm name,
rating (Buy / Overweight / Hold / Underweight / Sell), target price,
and publication date.
Pagination is controlled by ?page= (1-based) and ?records=.
Default: page 1, 10 records per page.
Tip: For estimates (EPS, revenue consensus) use
GET /markets/{marketId}/analyst-estimates. For a single company’s
opinions use GET /companies/{companyId}/analyst-opinions.
get
https://api.argaam.com/api/v1.1/markets/{marketId}/analyst-opinions
Query Parameters
Path Parameters
marketIdinteger(int32)required
Market ID (e.g. 1 for Saudi Tadawul).
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}/analyst-opinions
Authentication
Path Parameters
Query Parameters
200 application/json
Get financial results for a specific company within a market.
Returns the published financial statement results for a single company
within the market context, for the specified fiscal year and period.
This is a scoped version of GET /markets/{marketId}/financial-results
that narrows to one company without needing to filter client-side.
Period values — year (default), quarter, interim.
Tip: For the structured financial statement (income statement,
balance sheet) for a company use
GET /companies/{companyId}/financials/history?year={year}.
get
https://api.argaam.com/api/v1.1/markets/{marketId}/financial-results/{stockSymbol}
Query Parameters
yearinteger(int32)
Calendar year to filter by, e.g. 2025.
Example:2023
periodstring
Time window for the series, e.g. 1d, 1m, 3m, 1y, 5y. Defaults to year.
Default:year
Example:year
fiscalPeriodstring
Fiscal period within the year: 1-4 for quarters, 5 for the full year.
Default:
Example:year
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
stockSymbolstringrequired
Tadawul stock symbol of the company, e.g. 2222 (Saudi Aramco).
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}/financial-results/{stockSymbol}
Authentication
Path Parameters
Query Parameters
200 application/json
ApiV1Meta
object * Additional properties are NOT allowed.
pageinteger(int32)
pageSizeinteger(int32)
totalRecordsinteger(int32)
totalPagesinteger(int32)read-only
hasNextPagebooleanread-only
hasPreviousPagebooleanread-only
Example
ApiV1RateLimit
object * Additional properties are NOT allowed.
limitinteger(int32)
remaininginteger(int32)
resetstring(date-time)
Example
ApiV1Response
object * Additional properties are NOT allowed.
successboolean
apiVersionstring
timestampstring(date-time)
requestIdstring
data
metaobject
* Additional properties are NOT allowed.
Show Child Parameters
rateLimitobject
* Additional properties are NOT allowed.
Show Child Parameters
Example