Returns the market-level ratio identified by marketSymbol.
Numeric fiscal period type identifier (quarterly / half-yearly / annual). Defaults to 1.
Default:1
Example:1
When true, excludes Saudi Aramco (2222) from aggregates so a single mega-cap does not dominate market-level figures. Defaults to 0.
Default:0
Example:0
Numeric market identifier (e.g. 1 = Tadawul / Saudi main market). Use GET /api/v1.1/markets to list valid values.
Example:3
Success
Standardized successful API response wrapper for v1.0.0 endpoints.
Always true for successful responses.
Semantic API version (e.g., “1.0.0”).
UTC timestamp when the response was generated.
Unique request identifier for tracing.
The response payload.
Pagination and metadata information for collection responses.
Rate limit information returned with each response.
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