Returns the financial ratios for the company identified by stockSymbol.
Numeric market identifier (e.g. 1 = Tadawul / Saudi main market). Use GET /api/v1.1/markets to list valid values.
Default:3
Example:3
Time window for the series, e.g. 1d, 1m, 3m, 1y, 5y. Defaults to year.
Default:year
Example:year
Tadawul stock symbol of the company, e.g. 2222 (Saudi Aramco).
Example:2222
Success
Returns the historical series for the company identified by stockSymbol.
Calendar year to filter by, e.g. 2025.
Example:2023
Numeric market identifier (e.g. 1 = Tadawul / Saudi main market). Use GET /api/v1.1/markets to list valid values.
Default:3
Example:3
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
Tadawul stock symbol of the company, e.g. 2222 (Saudi Aramco).
Example:2222
Success
Returns the key financial highlights for the company identified by stockSymbol.
Numeric market identifier (e.g. 1 = Tadawul / Saudi main market). Use GET /api/v1.1/markets to list valid values.
Default:3
Example:3
Tadawul stock symbol of the company, e.g. 2222 (Saudi Aramco).
Example:2222
Success
Returns the analyst estimates for the company identified by stockSymbol.
Numeric market identifier (e.g. 1 = Tadawul / Saudi main market). Use GET /api/v1.1/markets to list valid values.
Default:3
Example:3
Time window for the series, e.g. 1d, 1m, 3m, 1y, 5y. Defaults to year.
Default:year
Example:year
Tadawul stock symbol of the company, e.g. 2222 (Saudi Aramco).
Example:2222
Success
Returns analyst estimates for the specified financial statement field
(fsFieldId) compared against actual published values for the same
period. Useful for building earnings-surprise charts and consensus
beat/miss dashboards.
Common fsFieldId values
| ID | Field |
|---|---|
54 (default) |
Net Income |
1 |
Revenue |
3 |
Operating Income |
8 |
EPS |
Period values — year (default), quarter, interim.
Tip: For ID-based estimates use
GET /companies/{id}/analyst-estimates.
Fiscal year to query (e.g. 2024).
Example:2024
Fiscal period type: year (default), quarter, or interim. Defaults to year.
Default:year
Example:year
Financial statement field ID to query. Default 54 (Net Income). Defaults to 54.
Default:54
Example:54
Company trading symbol / ticker (e.g. 2222 for Saudi Aramco).
Success