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
}

Bulk downloads

Financial statements and ratios for all companies are available as bulk CSV files. You can download them directly from the bulk fundamentals page, without API requests.

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 quarterly data to one fiscal quarter. Use this parameter only with period_type=quarterly.

Values: Q1Q2Q3Q4
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 for the specified fiscal year and all later fiscal years.

fiscal_year.gtinteger

Return statements only for fiscal years after the specified year.

fiscal_year.lteinteger

Return statements for the specified fiscal year and all earlier fiscal years.

fiscal_year.ltinteger

Return statements only for fiscal years before the specified 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

Token to request the next page of data. Each response returns ready-made next_page_url and previous_page_url (null on the last and first page, respectively) that repeat your filters with this token. They are relative and carry no credentials: prefix the API host and pass apikey separately, or keep sending your Authorization header.

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 on the last page. Request it unchanged to continue paging.

previous_page_urlnullable

URL of the previous page of results, or null on the first page. Request it unchanged to page back.

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.