Returns consensus analyst estimates for a specific financial statement
field across all coverage companies in the market for the given fiscal
year and period.
Common fsFieldId values
| ID | Field |
|---|---|
54 (default) |
Net Income |
1 |
Revenue |
3 |
Operating Income |
8 |
EPS |
Period values — year (default), quarter, interim.
Tip: For a single company’s estimates use
GET /companies/{companyId}/analyst-estimates.
Fiscal year (e.g. 2024).
Example:2023
Fiscal period type: year (default), quarter, or interim. Defaults to year.
Default:year
Example:year
Specific sub-period: year, q1–q4, i1–i3. Defaults to the period type’s natural value.
Default:
Example:year
Financial statement field ID. Default 54 (Net Income). Defaults to 54.
Default:54
Example:54
Market ID (e.g. 1 for Saudi Tadawul).
Example:3
Success
Returns the published financial statement results for all companies
in the specified market for the given fiscal year and period.
Useful for building a market-wide results summary table or for
comparing company-level performance within the same period.
Period values — year (default), quarter, interim.
Tip: To drill into a single company’s results within this market use
GET /markets/{marketId}/financial-results/{companyId}.
Fiscal year (e.g. 2023).
Example:2023
Fiscal period type: year (default), quarter, or interim. Defaults to year.
Default:year
Example:year
Specific sub-period: year, q1–q4, i1–i3.
Default:
Example:year
Market ID (e.g. 1 for Saudi Tadawul).
Example:3
Success
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.
Page number (1-based). Default: 1. Defaults to 1.
Default:1
Example:1
Records per page. Default: 10. Defaults to 10.
Default:10
Example:10
Market ID (e.g. 1 for Saudi Tadawul).
Example:3
Success
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}.
Calendar year to filter by, e.g. 2025.
Example:2023
Time window for the series, e.g. 1d, 1m, 3m, 1y, 5y. Defaults to year.
Default:year
Example:year
Fiscal period within the year: 1-4 for quarters, 5 for the full year.
Default:
Example:year
Numeric market identifier (e.g. 1 = Tadawul / Saudi main market). Use GET /api/v1.1/markets to list valid values.
Example:3
Tadawul stock symbol of the company, e.g. 2222 (Saudi Aramco).
Success