v3

latestOpenAPI 3.1.02026-07-26490368.4 KB

Ratios

Get all ratios time series for a company

Calculates and returns all supported financial ratios for the specified company across the selected period types.

get/v1/company/ratios

Query parameters

apiKeystring

API Key (alternatively send via X-Api-Key header)

tickerstring

Company ticker, use with mic or alone for US tickers

Example:MSFT

Company ticker, use with mic or alone for US tickers

micCodestring

Company MIC, use with ticker

Example:XNAS

Company MIC, use with ticker

exchangestring

Company exchange code, use with ticker

Example:NASDAQ

Company exchange code, use with ticker

companyKeystring

Company key (alternative to ticker/micCode/exchange)

Example:NASDAQ_MSFT

Company key (alternative to ticker/micCode/exchange)

cusipstring

Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP

Example:594918104

Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP

isinstring

Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN

Example:US5949181045

Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN

figistring

FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.

Example:BBG000BPH459

FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.

cikstring

Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.

Example:789019

Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.

fsclstring

Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.

Example:FSCLC6CGT4DXS597

Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.

periodTypestring

Optional period filter as a comma-separated list of: annual, quarterly, semi-annual, ltm, ytd, latest. Defaults to 'annual'.

Example:annual,quarterly

Optional period filter as a comma-separated list of: annual, quarterly, semi-annual, ltm, ytd, latest. Defaults to 'annual'.

currencystring

ISO 4217 target currency code (e.g., USD, CAD, EUR). Case-insensitive; system normalizes to uppercase. Must be 3-4 letters. Defaults to company's reporting currency.

Example:CAD

ratioIdstring

Return only these ratio IDs. Can be provided multiple times or as a comma-separated list.

Example:ratio_price_to_earnings,ratio_price_to_sales

Return only these ratio IDs. Can be provided multiple times or as a comma-separated list.

Response

All ratios time series

Example response

{
  "metrics": [
    {
      "ratioId": "price_to_earnings",
      "metricName": "Price to Earnings",
      "category": "Valuation",
      "metricFormat": "ratio",
      "hasDailyData": true
    }
  ],
  "data": [
    {
      "periodId": "3_Quarterly_2025-04-27",
      "periodType": "Quarterly",
      "reportDate": "2025-04-27",
      "periodDuration": "3 months",
      "calendarYear": 2025,
      "calendarQuarter": 2,
      "fiscalYear": 2026,
      "fiscalQuarter": 1,
      "stubType": "fye",
      "stubDuration": 214,
      "metricValues": {
        "market_data_share_price": 108.73,
        "market_data_total_shares_outstanding": 24388000000,
        "calculated_market_cap": 2651707240000,
        "ratio_price_to_sales": 60.18,
        "ratio_price_to_earnings": 143.07
      },
      "tradingCurrency": {
        "currency": "USD",
        "originalCurrency": "CAD",
        "appliedExchangeRate": 0.71
      },
      "reportingCurrency": {
        "currency": "USD",
        "originalCurrency": "CAD",
        "appliedExchangeRate": 0.71
      }
    }
  ]
}