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	FDPL

Response

Success Response (200)

{
  "status": "ok",
  "message": "",
  "data": {
    "symbol": "DGKC",
    "created": "2025-12-05T10:16:58.005Z",
    "interval": "annual",
    "consolidated": false,
    "type": "fundamentals",
    "periods": [
      {
        "year": "TTM",
        "period_end": "2025-09-30",
        "period_start": "2025-06-30",
        "year_end_diff": 3
      }
    ],
    "fields": [
      {
        "label": "Gross Profit Margin",
        "values": [
          0.2593432396843464
        ],
        "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"
      }
    ],
    "sector_stats": [
      {
        "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=FDPL" \
  -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