List liquidity ratios

Return short-term liquidity, cash-flow coverage, capital structure, and Altman Z-score ratios for one company across financial periods.

GET/v3.0.0/fundamental/ratios/liquidity/{identifier}

Plan Access

Free

(Your plan)

Individual

$29/mo

Professional

$89/mo

Plan History

Free

(Your plan)

2 years

Individual

$29/mo

5 years

Professional

$89/mo

40+ years

Request
curl "https://api.roic.ai/v3.0.0/fundamental/ratios/liquidity/NASDAQ:AAPL?apikey=YOUR_API_KEY&period_type=annual&fiscal_year.gte=2025&fiscal_year.lte=2025"
Response
200 OK
{
  "data": [
    {
      "id": "fnd_N7wh3Ukmc6CRKm",
      "symbol": "NASDAQ:AAPL",
      "period_type": "annual",
      "period_end_date": "2025-09-30",
      "fiscal_year": 2025,
      "period_label": "FY",
      "currency": "USD",
      "price_currency": "USD",
      "fx_applied": false,
      "object": "v3.fundamentals.liquidity_ratio",
      "cash_ratio": 0.3302340745391865,
      "cur_ratio": 0.8932929222186667,
      "quick_ratio": 0.7707132118987388,
      "cfo_to_avg_current_liabilities": 0.6518976793958301,
      "com_eqy_to_tot_asset": 22.075431256454582,
      "lt_debt_to_tot_eqy": 106.23194499070972,
      "lt_debt_to_tot_cap": 44.014137929096826,
      "lt_debt_to_tot_asset": 21.803747345097023,
      "tot_debt_to_tot_eqy": 133.80304612588665,
      "tot_debt_to_tot_cap": 55.4374273014874,
      "tot_debt_to_tot_asset": 27.46262258483859,
      "cash_flow_to_tot_liab": 39.046891855919974,
      "cap_expend_ratio": 8.767754620526937,
      "altman_z_score": 10.171330401116084
    }
  ],
  "next_page_url": null,
  "previous_page_url": null
}

Parameters

Path parameters

identifierstringrequired

A ticker ID, an exchange and symbol separated by a colon (e.g. NASDAQ:AAPL), or a FIGI.

Examples: NASDAQ:AAPLtkr_cO46h8pgSu9QqyBBG000B9XRY4

Query parameters

period_typestringoptional

Financial period cadence.

Default: annualValues: annualquarterlyttm
period_labelstringoptional

Filter to a specific period within the fiscal year: FY for annual periods, or Q1–Q4 for quarterly and TTM periods.

Values: FYQ1Q2Q3Q4
datestringoptional

Pass a YYYY-MM-DD date directly for an exact period-end-date match. For a range, combine the modifiers below, for example, date.gte=2020-01-01&date.lt=2026-01-01.

+ Show filter modifiers
date.gtestring

Return statements whose period end date is on or after this date.

date.gtstring

Return statements whose period end date is strictly after this date.

date.ltestring

Return statements whose period end date is on or before this date.

date.ltstring

Return statements whose period end date is strictly before this date.

fiscal_yearobjectoptional

Filter by fiscal year. Combine the range modifiers below to select the reporting years you need.

+ Show filter modifiers
fiscal_year.gteinteger

Return statements from this fiscal year onward.

fiscal_year.gtinteger

Return statements after this fiscal year.

fiscal_year.lteinteger

Return statements through this fiscal year.

fiscal_year.ltinteger

Return statements before this fiscal year.

orderstringoptional

Sort by period end date (period_end_date).

Default: descValues: ascdesc
limitintegeroptional

Maximum number of resources to return.

Default: 50Min: 1Max: 100
pagestringoptional

Opaque page token from a previous response. Follow the returned page URL when possible.

Response

Each normalized liquidity ratio is a top-level field on the period resource. Missing values are null.

Response fields

dataarray of objects

Array of financial period resources for the current page, one per reporting period.

+ Show child attributes
idstring

Unique identifier for the financial period record, beginning with fnd_. Store it as the stable reference to this period's figures.

symbolstring

Qualified symbol combining the exchange code and ticker separated by a colon, e.g. NASDAQ:AAPL.

period_typestring

Cadence of the period: annual for full fiscal years, quarterly for fiscal quarters, or ttm for trailing-twelve-month aggregates.

period_end_datestring

Last calendar day of the financial period, in YYYY-MM-DD format.

fiscal_yearnumber

Fiscal year the period belongs to, e.g. 2025. Fiscal years may not align with calendar years; Apple's fiscal 2025 ends in September 2025.

period_labelstring

Label of the period within the fiscal year: FY for annual periods, or Q1 through Q4 for quarters.

currencystring

ISO 4217 code of the currency the financial values are reported in, e.g. USD.

price_currencystring

ISO 4217 code of the currency used for price-derived values such as market capitalization. It can differ from currency when the listing trades in another currency.

fx_appliedboolean

Whether metric values were converted from the company's reporting currency. false means the figures are as originally reported.

objectstring

String representing the object's type, e.g. v3.fundamentals.income_statement. Each fundamentals endpoint returns its own object type.

cash_rationumber

Cash Ratio: Shows how much cash and near-cash assets a company has to pay off its current liabilities.

cur_rationumber

Current Ratio: Measures how well a company can pay its short-term debts with its short-term assets.

quick_rationumber

Quick Ratio: Shows how much cash and other liquid assets a company has to pay off its current liabilities.

cfo_to_avg_current_liabilitiesnumber

CFO/Avg Current Liab: Shows how many times a company can pay off its current liabilities with cash generated from normal business activities in the past year.

com_eqy_to_tot_assetnumber

Common Equity/Total Assets: Measures a company's financial health and long-term profitability.

lt_debt_to_tot_eqynumber

Long-Term Debt/Equity (%): Measures a company's leverage or how much it relies on debt to finance its assets.

lt_debt_to_tot_capnumber

Long-Term Debt/Capital (%): Measures a company's financial leverage or how much it relies on debt to finance its assets.

lt_debt_to_tot_assetnumber

Long-Term Debt/Total Assets (%): Measures a company's financial leverage or how much it relies on debt to finance its assets.

tot_debt_to_tot_eqynumber

Total Debt/Equity (%): Measures a company's financial leverage or how much it relies on debt to finance its assets.

tot_debt_to_tot_capnumber

Total Debt/Capital (%): Measures a company's financial leverage or how much it relies on debt to finance its assets.

tot_debt_to_tot_assetnumber

Total Debt/Total Assets (%): Shows how much a company relies on debt to finance its assets and operations.

cash_flow_to_tot_liabnumber

CFO/Total Liabilities: Shows how much cash a company generates from normal business activities in relation to its total debt.

cap_expend_rationumber

CFO/CapEx: Shows how much cash a company generates from normal business activities in relation to its spending on fixed assets.

altman_z_scorenumber

Altman's Z-Score: Indicates the probability of a company filing for bankruptcy within the next two years.

next_page_urlnullable

URL of the next page of results, or null when there are no more pages. Request it unchanged to continue paging.

previous_page_urlnullable

URL of the previous page of results, or null on the first page.

Example

Return the liquidity ratios whose period ends on one exact date.

curl "https://api.roic.ai/v3.0.0/fundamental/ratios/liquidity/NASDAQ:AAPL?apikey=YOUR_API_KEY&period_type=annual&date=2025-09-30"

Related endpoints

Combine liquidity with debt and working-capital measures.