> ## Documentation Index > Fetch the complete documentation index at: https://docs.chicago.global/llms.txt > Use this file to discover all available pages before exploring further. # Key Ratios > Retrieve key financial ratios for a given stock symbol. Returns profitability, liquidity, leverage, and efficiency ratios sourced from LSEG Datastream. Retrieve key financial ratios for a given stock symbol. Returns profitability, liquidity, leverage, and efficiency ratios sourced from LSEG Datastream. ## Query Parameters | Parameter | Type | Required | Default | Description | | --------- | ------- | -------- | ------- | --------------------------------------------------------------------------------------------------------------------------- | | `symbol` | string | Yes | — | Stock symbol (e.g., `AAPL.O`, `0700.HK`). Ticker shorthand like `AAPL` is also accepted and will be resolved automatically. | | `limit` | integer | No | `4` | Number of periods to return | | `freq` | integer | No | `1` | `1` for Annual, `2` for Quarterly | ## Response Returns an array of period objects with key financial ratios: ```json theme={null} [ { "ric": "AAPL.O", "rkdcode": 319, "perenddt": "2025-09-27", "stmtdt": "2025-09-27", "sourcedt": "2025-10-31", "year": 2025, "gross_margin": 46.91, "ebitda_margin": 34.78, "operating_margin": 31.97, "pretax_margin": 31.89, "effective_tax_rate": 15.98, "net_margin": 26.8, "return_on_equity": 170.68, "return_on_assets": 31.18, "return_on_invested_capital": 58.36, "fcf_yield": 2.61, "dividend_yield": 0.41, "pe": 34.22, "price_book_value": 51.42, "price_cash_flow": 34.01, "price_sales": 9.11, "enterprise_value_revenue": 9.22, "enterprise_value_ebit": 28.83, "quick_ratio": 0.86, "current_ratio": 0.89, "ebitda_interest_expense": null, "times_interest_earned": null, "total_debt_ebitda": 0.69, "assets_equity": 4.87, "debt_equity": 1.35, "lt_debt_to_total_capital": 0.4551, "total_debt_enterprise_value": 0.026, "net_debt_to_ebitda": 0.31, "cash_cycle_days": -42.9 } ] ``` Margin and return ratios are expressed as percentages. Valuation multiples (P/E, P/B, etc.) are expressed as ratios. Fields with `null` values are not applicable for the given company. ## Key Fields | Field | Description | | ---------------------------- | --------------------------------------- | | **Profitability** | | | `gross_margin` | Gross profit as % of revenue | | `ebitda_margin` | EBITDA as % of revenue | | `operating_margin` | Operating income as % of revenue | | `net_margin` | Net income as % of revenue | | `return_on_equity` | Net income as % of shareholders' equity | | `return_on_assets` | Net income as % of total assets | | `return_on_invested_capital` | ROIC | | **Valuation** | | | `pe` | Price-to-earnings ratio | | `price_book_value` | Price-to-book ratio | | `price_sales` | Price-to-sales ratio | | `enterprise_value_ebit` | EV/EBIT | | `fcf_yield` | Free cash flow yield (%) | | `dividend_yield` | Dividend yield (%) | | **Liquidity & Leverage** | | | `current_ratio` | Current assets / current liabilities | | `quick_ratio` | Quick assets / current liabilities | | `debt_equity` | Total debt / shareholders' equity | | `net_debt_to_ebitda` | Net debt / EBITDA | ## Example ```bash theme={null} curl "https://api.chicago.global/v1/key-ratios?symbol=AAPL.O&limit=4&freq=1" \ -H "Authorization: Bearer YOUR_API_KEY" ``` ```javascript theme={null} const response = await fetch( 'https://api.chicago.global/v1/key-ratios?symbol=AAPL.O&limit=4&freq=1', { headers: { 'Authorization': `Bearer ${API_KEY}` } } ); const periods = await response.json(); console.log(`ROE: ${periods[0].return_on_equity}%`); console.log(`Net Margin: ${periods[0].net_profit_margin}%`); ``` ## OpenAPI ````yaml GET /v1/key-ratios openapi: 3.1.0 info: title: Parallax API description: >- Financial data and portfolio analytics API. Analyze portfolios with multi-currency support, rebalancing, and comprehensive metrics. version: 1.0.0 servers: - url: https://api.chicago.global security: - bearerAuth: [] paths: /v1/key-ratios: get: tags: - Financial Statements summary: Key Ratios description: >- Retrieve key financial ratios for a given stock symbol. Returns profitability, liquidity, leverage, and efficiency ratios sourced from LSEG Datastream. operationId: getKeyRatios parameters: - name: symbol in: query required: true description: >- Stock symbol (e.g., AAPL.O, 0700.HK). Ticker shorthand like AAPL is also accepted. schema: type: string example: AAPL.O - name: limit in: query required: false description: Number of periods to return schema: type: integer default: 4 example: 4 - name: freq in: query required: false description: 1 for Annual, 2 for Quarterly schema: type: integer enum: - 1 - 2 default: 1 example: 1 responses: '200': description: Key ratios retrieved successfully content: application/json: schema: type: array items: $ref: '#/components/schemas/KeyRatiosPeriod' '401': description: Unauthorized - Invalid or missing API key content: application/json: schema: $ref: '#/components/schemas/Error' components: schemas: KeyRatiosPeriod: type: object properties: ric: type: string description: Reuters Instrument Code perenddt: type: string format: date description: Period end date year: type: integer description: Fiscal year gross_margin: type: number nullable: true description: Gross profit as % of revenue ebitda_margin: type: number nullable: true description: EBITDA as % of revenue operating_margin: type: number nullable: true description: Operating income as % of revenue net_margin: type: number nullable: true description: Net income as % of revenue return_on_equity: type: number nullable: true description: ROE (%) return_on_assets: type: number nullable: true description: ROA (%) return_on_invested_capital: type: number nullable: true description: ROIC (%) pe: type: number nullable: true description: Price-to-earnings ratio price_book_value: type: number nullable: true description: Price-to-book ratio price_sales: type: number nullable: true description: Price-to-sales ratio enterprise_value_ebit: type: number nullable: true description: EV/EBIT fcf_yield: type: number nullable: true description: Free cash flow yield (%) dividend_yield: type: number nullable: true description: Dividend yield (%) current_ratio: type: number nullable: true description: Current assets / current liabilities quick_ratio: type: number nullable: true description: Quick assets / current liabilities debt_equity: type: number nullable: true description: Total debt / shareholders' equity net_debt_to_ebitda: type: number nullable: true description: Net debt / EBITDA Error: type: object properties: detail: type: string description: Error message securitySchemes: bearerAuth: type: http scheme: bearer description: API key passed as Bearer token ````