Financial Ratios
Retrieve comprehensive financial ratios and performance metrics for a specific company on an annual basis.
GET/3.0/company/financials/fundamentals/annual
Description
This endpoint returns calculated financial ratios and fundamental metrics including profitability ratios, liquidity ratios, solvency ratios, efficiency ratios, and valuation ratios on an annual basis. Provides key financial indicators for comprehensive analysis of company's financial health and performance.
Request
Authentication
- Type: Bearer Token
- Required: Yes
Parameters
| Name | Type | Required | Description | Example |
|---|---|---|---|---|
symbol | string | Yes | Stock symbol/ticker code for the company | DGKC |
Available Metrics
| Metric | Description |
|---|---|
| Gross Profit Margin | Assesses the profitability of a company's core operations, excluding fixed cost |
| Operating Profit Margin | Assesses what proportion of revenue is left after paying off all operating costs |
| Profit Before Tax Margin | Assesses the percentage of revenue translated into profits before any tax is paid |
| Net Profit Margin | Assesses the percentage of revenue translated into profits |
| Other Operating Income | Determines proportion of profits earned through activities other than company's core operations |
| Return on Capital Employed | Measures how efficiently a company utilises its capital to generate profits |
| Return on Equity | Shows the percentage of profit generated through each rupee invested by equity holders |
| Return on Assets | Indication of how effectively a company uses its assets to generate profits |
| Dividend Per Share | The portion of company's earnings distributed to shareholders in the form of cash |
| Dividend Yield | Shareholders earnings on investments in cash as a percentage of share price at year end |
| Dividend Cover | Number of times a company is capable of paying out dividends from its profit |
| Retention Ratio | Measures the proportion of profits held back by the company to fund its operations |
| Number of Shares | Total shares outstanding, derived from profit after tax and EPS |
| Payout Ratio | Measures the proportion of profits given out to shareholders |
| Sales per Share | Computes the total revenue earned per share in a year's time |
| Market Price per Share | Current price of the share |
| Earnings per Share | Profits per share earned |
| Book Value per Share (Rs.) | Indication of asset value of a company if it liquidates immediately |
| Price Earnings Ratio | Determines the price an investor is paying for each rupee of company's earnings |
| Price/Book Ratio | Estimates the amount of equity investors are paying for each rupee in net assets |
| Price To Sales Ratio | Indicates how many times investors are paying for every rupee of a company's sales |
| Net Assets per Share | Measures the ability of a company to finance customer withdrawals |
| Capital Employed | Total amount of capital used for the acquisition of profits |
| Equity Multiplier | Determines the amount of assets financed through equity |
| Equity to Assets | Measures the proportion of assets financed through equity |
| Long term Debt to Equity | Proportion of assets invested in a business financed by long-term borrowing |
| Long term Debt to Assets | Measures the proportion of assets financed through long term debt |
| Liabilities to Assets | Examines what proportion of assets are financed through liabilities |
| Solvency Ratio | Measure of the company's ability to service its debt obligations |
| Interest Cover | Measures the ability to cover interest expense from operating profit |
| Cash per Share | Cash and bank balances available per outstanding share |
| Current Ratio | Ability to finance short-term liabilities through current assets over 12 months |
| Quick Ratio | Ability to finance short-term liabilities through liquid (near-cash) current assets |
| Working Capital | The money available to a company for its day to day operations |
| Receivable Days | Average number of days a company takes to collect revenue after a sale |
| Inventory Days | Average number of days a company takes to turn its inventory into sales |
| Payables Days | Average number of days a company takes to pay its trade creditors |
| Working Capital (Days) | How long it takes for a company to convert its working capital into sales |
| Total Assets Turnover | The efficiency of a company's use of its assets in generating sales revenue |
| Fixed Asset Turnover (Times) | Ability to generate sales from fixed assets (property, plant and equipment) |
| Inventory Turnover (Times) | Number of times a company's inventory is sold or replaced in the period |
Response
Success Response (200)
{
"status": "ok",
"message": "",
"data": {
"symbol": "DGKC",
"created": "2025-06-24T07:06:08.127Z",
"interval": "annual",
"consolidated": false,
"type": "fundamentals",
"periods": [
{
"year": "TTM",
"period_end": "2025-03-31",
"period_start": "2024-12-31",
"year_end_diff": 9
},
{
"year": "2024",
"period_end": "2024-06-30",
"year_end_diff": 12
}
],
"fields": [
{
"label": "Gross Profit Margin",
"values": [
0.20121144673525806,
0.15942563608432628
],
"is_heading": false,
"description": "Asseses the profitability of a company's core operations, excluding fixed cost",
"latex": "$$Gross\\ Profit\\ Margin= \\frac {Gross\\ Profit}{Sales}$$",
"unit": "%",
"key": "gpm"
},
{
"label": "Operating Profit Margin",
"values": [
0.1825660018622728,
0.16414642937566493
],
"is_heading": false,
"description": "Assesses what proportion of revenue is left after paying off all operating costs",
"latex": "$$Operating\\ Profit\\ Margin= \\frac{Profit\\ from\\ Operations}{Sales}$$",
"unit": "%",
"key": "opm"
},
{
"label": "Equity to Assets",
"values": [
0.5997171776609681,
0.5480877605363916
],
"is_heading": false,
"description": "Measures the proportion of assets financed through equity",
"latex": "$$ Equity\\ to\\ Assets = \\frac{Total\\ Equity}{Total\\ Assets}$$",
"unit": "%",
"key": "eta"
},
{
"label": "Interest Cover",
"values": [
2.5179661175159986,
1.3548147412138698
],
"is_heading": false,
"description": "Measures the ability to cover interest expense from operating profit",
"latex": "$$Interest\\ Cover= \\frac{Profit\\ from\\ Operations}{Finance\\ Cost}$$",
"unit": "Times",
"key": "intc"
},
{
"label": "Current Ratio",
"values": [
1.608972530296715,
1.2961859312548423
],
"is_heading": false,
"description": "Measures the ability of a company to finance its short term liabilities through its current assets over a period of 12 months",
"latex": "$$Current\\ Ratio = \\frac{Total\\ Current\\ Assets}{Total\\ Current\\ Liabilities} $$",
"unit": "Times",
"key": "cur_ratio"
}
],
"sector_stats": [
{
"key": "gpm",
"min": -0.7070653847252597,
"max": 0.6037953506458755,
"median": 0.21371531896179993
},
{
"key": "opm",
"min": -0.8573718508267125,
"max": 0.4916114343134451,
"median": 0.16237928455984124
},
{
"key": "eta",
"min": -0.29748373304949965,
"max": 0.9697122746905973,
"median": 0.519009843482243
},
{
"key": "intc",
"min": -176.88867059593974,
"max": 45.30300745400491,
"median": 0.6417342275620932
},
{
"key": "cur_ratio",
"min": 0.2175848121176299,
"max": 31.269924609585352,
"median": 2.895424636534144
}
]
}
}
Response Fields
| Field | Type | Description |
|---|---|---|
symbol | string | Company stock symbol |
created | string | Data creation timestamp (ISO 8601 format) |
interval | string | Reporting interval (annual, quarterly) |
consolidated | boolean | Whether financials are consolidated |
type | string | Type of financial data (fundamentals) |
periods | array | Array of reporting periods View |
fields | array | Array of financial ratio fields View |
sector_stats | array | Array of sector statistics View |
Periods Array Fields
| Field | Type | Description |
|---|---|---|
year | string | Fiscal year or period indicator (e.g., TTM for Trailing Twelve Months) |
period_end | string | Period end date (YYYY-MM-DD) |
period_start | string | Period start date (YYYY-MM-DD) if applicable (e.g., for TTM) |
year_end_diff | integer | Month difference from year end |
Fields Array Fields
| Field | Type | Description |
|---|---|---|
label | string | Financial ratio label/name |
values | array | Array of calculated ratio values for each period |
is_heading | boolean | Whether this is a section heading |
description | string | Detailed description of what the ratio measures |
latex | string | LaTeX formula for the ratio calculation |
unit | string | Unit of measurement (%, ratio, days, etc.) |
key | string | Machine-readable key for the ratio |
Sector Stats Array Fields
| Field | Type | Description |
|---|---|---|
key | string | Sector metric key |
min | number | Minimum value in the sector |
max | number | Maximum value in the sector |
median | number | Median value in the sector |
Error Responses
For detailed Common Error responses, see the Error Handling.
Missing Symbol (200)
{
"status": "error",
"message": "no `symbol` provided"
}
Examples
Get Annual Financial Ratios
curl -X GET "https://csapis.com/3.0/company/financials/fundamentals/annual?symbol=DGKC" \
-H "Authorization: Bearer YOUR_API_TOKEN"
Use Cases
- Fundamental Analysis: Comprehensive financial ratio analysis for valuation
- Comparative Analysis: Compare company ratios with industry peers
- Trend Analysis: Track ratio trends over multiple years
- Financial Health: Assess overall financial health using multiple metrics
- Credit Assessment: Evaluate credit quality using solvency ratios
- Valuation Models: Use valuation ratios in DCF and relative valuation
- Risk Assessment: Identify risks using liquidity and solvency metrics
- Investment Screening: Screen stocks based on ratio criteria