Returns companies in the market ranked highest-first by the requested metric.
Numeric market identifier (e.g. 1 = Tadawul / Saudi main market). Use GET /api/v1.1/markets to list valid values.
Example:3
Ranking metric to sort by (e.g. pe, market-cap, dividend-yield).
Success
Returns the twenty lowest-ranked companies in the market for the requested metric.
Time window for the series, e.g. 1d, 1m, 3m, 1y, 5y. Defaults to quarter.
Default:quarter
Example:year
Numeric market identifier (e.g. 1 = Tadawul / Saudi main market). Use GET /api/v1.1/markets to list valid values.
Example:3
Ranking metric to sort by (e.g. pe, market-cap, dividend-yield).
Success
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