Stock Historical Ratios
Stock Financial Ratio Comparison
This API endpoint provides a detailed comparison of financial ratios for a specified stock symbol in a given region. It includes metrics like growth, normalized values, and details such as individual ratio components compared to sector averages.
Parameters
| Name | Description | Example | Parameter Type | Data Type |
|---|---|---|---|---|
| region | Region code (tr, us) | query | string | |
| symbol | Symbol of the stock. | TUPRS | query | string |
Response
(Note: Actual response can be different length and other fields may be present)
Stock Financial Ratios
Retrieves historical financial ratios for a specified stock symbol in a given region. The response includes various financial metrics such as PE ratio, ROE, ROA, and ROIC for different fiscal years and quarters, along with sector averages for comparison.
Parameters
| Name | Description | Example | Parameter Type | Data Type |
|---|---|---|---|---|
| region | Region code (tr, us) | query | string | |
| symbol | Symbol of the stock. | TUPRS | query | string |
| slugs | Comma-separated list of financial ratios to retrieve (e.g., "pe-ratio,roe,roa,roic"). | pe-ratio,roe,roa,roic | query | string |
Response
(Note: Actual response can be different length and other fields may be present)
Stock Historical Ratios Descriptions
Provides descriptions of various financial ratios in the specified locale. This endpoint is useful for understanding the meaning and significance of different financial metrics used in historical ratios.
Parameters
| Name | Description | Example | Parameter Type | Data Type |
|---|---|---|---|---|
| locale | Locale code (tr, en) | query | string | |
| region | Region code (tr, us) | query | string |
Response
(Note: Actual response can be different length and other fields may be present)
Stock Historical Financial Sheets
Retrieves historical financial sheet data for a specified stock symbol within a given date range. This endpoint provides detailed financial sheet information such as balance sheets, with options for cumulative or periodic reports, in a specified currency and region.
Parameters
| Name | Description | Example | Parameter Type | Data Type |
|---|---|---|---|---|
| from | Start date in YYYY-MM-DD format. | 2021-01-01 | query | string |
| to | Start date in YYYY-MM-DD format. | 2021-10-01 | query | string |
| symbol | Symbol of the stock. | TUPRS | query | string |
| region | Region code (tr, us) | query | string | |
| sheetType | Type of financial sheet (e.g., balanceSheet). | query | string | |
| periodType | When financial statements are reported, they are usually reported “cumulative". For example 2022/6 is reported as the first 6 months and 2022/9 for the first 9 months. To get the income for the 3rd quarter (and only the 3rd quarter, so between months 6 and 9), we would need to subtract the cumulative 2022/9 value from the cumulative 2022/6 value. The trailing 4 quarters can be added to annualize these values, which removes the seasonal nature of data. | query | string | |
| currency | Currency in which the financial data is returned. If the region is set to "us", only accepted value is "USD" otherwise all currencies are valid. | query | string |
Response
(Note: Actual response can be different length and other fields may be present)