Table of Contents

Class FinancialRatios

Namespace
MassiveDotNet.Rest.Models
Assembly
MassiveDotNet.Rest.dll

The valuation, profitability, liquidity, and leverage ratios computed for one ticker on one date.

public sealed record FinancialRatios : IEquatable<FinancialRatios>
Inheritance
FinancialRatios
Implements
Inherited Members

Remarks

Reference data, so a class (decision D4). Ticker, Date, and Price are the three properties the description requires; every ratio is optional, and absent means it could not be computed rather than that it is zero — PriceToEarnings, for one, exists only where earnings per share is positive, and the wire does omit it there, where a company that simply pays no dividend reports a DividendYield of zero. This is the one route in the family observed using the distinction. CurrentRatio, QuickRatio, and CashRatio rename the wire's bare current, quick, and cash, which name no ratio on their own.

Properties

AverageVolume

Average trading volume over the last 30 trading days, providing context for liquidity.

[JsonPropertyName("average_volume")]
public double? AverageVolume { get; init; }

Property Value

double?

CashRatio

The cash ratio: cash and cash equivalents divided by current liabilities, the strictest of the three liquidity measures. The wire's bare cash.

[JsonPropertyName("cash")]
public double? CashRatio { get; init; }

Property Value

double?

Cik

Central Index Key (CIK) number assigned by the SEC to identify the company.

[JsonPropertyName("cik")]
public string? Cik { get; init; }

Property Value

string

CurrentRatio

The current ratio: total current assets divided by total current liabilities, measuring short-term liquidity. The wire's bare current.

[JsonPropertyName("current")]
public double? CurrentRatio { get; init; }

Property Value

double?

Date

The date the ratios are computed for, which is the trading date the price comes from. The description types this a bare string; the wire carries an ISO calendar date (D-R9).

[JsonPropertyName("date")]
public LocalDate Date { get; init; }

Property Value

LocalDate

DebtToEquity

Debt-to-equity ratio, calculated as total debt (current debt plus long-term debt) divided by total shareholders' equity, measuring financial leverage.

[JsonPropertyName("debt_to_equity")]
public double? DebtToEquity { get; init; }

Property Value

double?

DividendYield

Dividend yield, calculated as annual dividends per share divided by stock price, measuring the income return on investment.

[JsonPropertyName("dividend_yield")]
public double? DividendYield { get; init; }

Property Value

double?

EarningsPerShare

Earnings per share, calculated as trailing twelve months (TTM) net income available to common shareholders divided by point-in-time shares outstanding as of the price date, assuming all shares of other share classes are converted to this share class. This is not weighted average basic or diluted shares outstanding, so this value will not match the reported basic or diluted EPS on the income statements endpoint.

[JsonPropertyName("earnings_per_share")]
public double? EarningsPerShare { get; init; }

Property Value

double?

EnterpriseValue

Enterprise value, calculated as market capitalization plus total debt minus cash and cash equivalents, representing total company value.

[JsonPropertyName("enterprise_value")]
public double? EnterpriseValue { get; init; }

Property Value

double?

EvToEbitda

Enterprise value to EBITDA ratio, calculated as enterprise value divided by EBITDA, measuring company valuation relative to earnings before interest, taxes, depreciation, and amortization.

[JsonPropertyName("ev_to_ebitda")]
public double? EvToEbitda { get; init; }

Property Value

double?

EvToSales

Enterprise value to sales ratio, calculated as enterprise value divided by revenue, measuring company valuation relative to sales.

[JsonPropertyName("ev_to_sales")]
public double? EvToSales { get; init; }

Property Value

double?

FreeCashFlow

Free cash flow, calculated as operating cash flow minus capital expenditures (purchase of property, plant, and equipment).

[JsonPropertyName("free_cash_flow")]
public double? FreeCashFlow { get; init; }

Property Value

double?

MarketCap

Market capitalization, calculated as stock price multiplied by total shares outstanding.

[JsonPropertyName("market_cap")]
public double? MarketCap { get; init; }

Property Value

double?

Price

Stock price used in ratio calculations, typically the closing price for the given date.

[JsonPropertyName("price")]
public double Price { get; init; }

Property Value

double

PriceToBook

Price-to-book ratio, calculated as stock price divided by book value per share, comparing market value to book value.

[JsonPropertyName("price_to_book")]
public double? PriceToBook { get; init; }

Property Value

double?

PriceToCashFlow

Price-to-cash-flow ratio, calculated as stock price divided by operating cash flow per share. Only calculated when operating cash flow per share is positive.

[JsonPropertyName("price_to_cash_flow")]
public double? PriceToCashFlow { get; init; }

Property Value

double?

PriceToEarnings

Price-to-earnings ratio, calculated as stock price divided by earnings per share. Only calculated when earnings per share is positive.

[JsonPropertyName("price_to_earnings")]
public double? PriceToEarnings { get; init; }

Property Value

double?

PriceToFreeCashFlow

Price-to-free-cash-flow ratio, calculated as stock price divided by free cash flow per share. Only calculated when free cash flow per share is positive.

[JsonPropertyName("price_to_free_cash_flow")]
public double? PriceToFreeCashFlow { get; init; }

Property Value

double?

PriceToSales

Price-to-sales ratio, calculated as stock price divided by revenue per share, measuring valuation relative to sales.

[JsonPropertyName("price_to_sales")]
public double? PriceToSales { get; init; }

Property Value

double?

QuickRatio

The quick ratio: liquid current assets divided by total current liabilities, excluding inventory from the numerator. The wire's bare quick.

[JsonPropertyName("quick")]
public double? QuickRatio { get; init; }

Property Value

double?

ReturnOnAssets

Return on assets ratio, calculated as net income divided by total assets, measuring how efficiently a company uses its assets to generate profit.

[JsonPropertyName("return_on_assets")]
public double? ReturnOnAssets { get; init; }

Property Value

double?

ReturnOnEquity

Return on equity ratio, calculated as net income divided by total shareholders' equity, measuring profitability relative to shareholders' equity.

[JsonPropertyName("return_on_equity")]
public double? ReturnOnEquity { get; init; }

Property Value

double?

Ticker

Stock ticker symbol for the company.

[JsonPropertyName("ticker")]
public required string Ticker { get; init; }

Property Value

string