# Fundamentals catalog — Tickerbot Fundamentals API

113 columns. Group overview from https://tickerbot.io/docs/signals/catalog/fundamentals/ · full catalog: https://tickerbot.io/docs/signals/catalog.md · concept: https://tickerbot.io/docs/signals.md

Company financials: statement lines as reported, ratios derived from them, market-price multiples on top of them, share structure, and short positioning.

## Income statement

Income-statement lines as reported, EPS, and their growth rates.

- [basic_earnings_per_share](https://tickerbot.io/docs/signals/basic_earnings_per_share.md) (numeric) — Basic EPS for the most-recently reported quarter. Signed.
- [benefits_costs_expenses](https://tickerbot.io/docs/signals/benefits_costs_expenses.md) (bigint) — Benefits and post-employment costs line item, where reported. Mostly insurance / utility issuers.
- [cost_of_revenue](https://tickerbot.io/docs/signals/cost_of_revenue.md) (bigint) — Cost of goods sold for the quarter.
- [costs_and_expenses](https://tickerbot.io/docs/signals/costs_and_expenses.md) (bigint) — Total costs and expenses reported on the income statement (COGS + opex).
- [diluted_eps_ttm](https://tickerbot.io/docs/signals/diluted_eps_ttm.md) (numeric) — Trailing-12m diluted EPS.
- [earnings_growth_yoy](https://tickerbot.io/docs/signals/earnings_growth_yoy.md) (numeric) — Year-over-year EPS growth percent from the most recently reported quarter vs. the same quarter prior year. Signed; positive = growth.
- [ebitda](https://tickerbot.io/docs/signals/ebitda.md) (bigint) — Earnings before interest, taxes, depreciation, and amortization (TTM).
- [eps](https://tickerbot.io/docs/signals/eps.md) (numeric) — Earnings per share (trailing twelve months).
- [gross_profit](https://tickerbot.io/docs/signals/gross_profit.md) (bigint) — `revenues − cost_of_revenue` for the quarter.
- [gross_profit_ttm](https://tickerbot.io/docs/signals/gross_profit_ttm.md) (bigint) — Trailing-12m gross profit.
- [income_loss_from_continuing_operations_after_tax](https://tickerbot.io/docs/signals/income_loss_from_continuing_operations_after_tax.md) (bigint) — After-tax income from continuing operations for the quarter.
- [income_loss_from_continuing_operations_before_tax](https://tickerbot.io/docs/signals/income_loss_from_continuing_operations_before_tax.md) (bigint) — Pre-tax income from continuing operations for the quarter.
- [income_tax_expense_benefit](https://tickerbot.io/docs/signals/income_tax_expense_benefit.md) (bigint) — Income tax expense (positive) or benefit (negative) for the quarter.
- [income_tax_expense_benefit_deferred](https://tickerbot.io/docs/signals/income_tax_expense_benefit_deferred.md) (bigint) — Deferred portion of income tax. Rare line item.
- [net_income_loss](https://tickerbot.io/docs/signals/net_income_loss.md) (bigint) — Bottom-line net income/loss for the quarter. Signed.
- [net_income_loss_attributable_to_noncontrolling_interest](https://tickerbot.io/docs/signals/net_income_loss_attributable_to_noncontrolling_interest.md) (bigint) — Portion of net income attributable to minority owners of consolidated subsidiaries. Usually 0 for non-conglomerates.
- [net_income_loss_attributable_to_parent](https://tickerbot.io/docs/signals/net_income_loss_attributable_to_parent.md) (bigint) — Net income attributable to the parent entity (excludes noncontrolling interest).
- [net_income_loss_available_to_common_stockholders_basic](https://tickerbot.io/docs/signals/net_income_loss_available_to_common_stockholders_basic.md) (bigint) — Net income available to common shareholders — numerator for basic EPS.
- [nonoperating_income_loss](https://tickerbot.io/docs/signals/nonoperating_income_loss.md) (bigint) — Non-operating income/loss (interest income, gains/losses on investments, etc.) for the quarter. Signed.
- [operating_expenses](https://tickerbot.io/docs/signals/operating_expenses.md) (bigint) — Sum of operating costs reported on the income statement for the quarter (excludes COGS).
- [operating_income_loss](https://tickerbot.io/docs/signals/operating_income_loss.md) (bigint) — Operating income or loss for the quarter. Signed.
- [research_and_development](https://tickerbot.io/docs/signals/research_and_development.md) (bigint) — R&D spend for the quarter. NULL for companies that don't report R&D as a line item.
- [revenue_growth_yoy](https://tickerbot.io/docs/signals/revenue_growth_yoy.md) (numeric) — Year-over-year revenue growth: most-recent quarter vs same quarter prior year. Signed; positive = growth.
- [revenue_growth_yoy_quarterly](https://tickerbot.io/docs/signals/revenue_growth_yoy_quarterly.md) (numeric) — YoY quarterly revenue growth. Signed.
- [revenue_per_share_ttm](https://tickerbot.io/docs/signals/revenue_per_share_ttm.md) (numeric) — Trailing-12m revenue divided by diluted shares outstanding. USD per share.
- [revenue_ttm](https://tickerbot.io/docs/signals/revenue_ttm.md) (bigint) — Trailing-twelve-month revenue.
- [revenues](https://tickerbot.io/docs/signals/revenues.md) (bigint) — Total revenue for the most-recently reported quarter, from filed income statements.
- [selling_general_and_administrative_expenses](https://tickerbot.io/docs/signals/selling_general_and_administrative_expenses.md) (bigint) — SG&A for the quarter.
- [wages](https://tickerbot.io/docs/signals/wages.md) (bigint) — Wages and salaries line item, where reported. Rare — most companies fold this into SG&A.

## Balance sheet

Balance-sheet lines as reported.

- [accounts_payable](https://tickerbot.io/docs/signals/accounts_payable.md) (bigint) — Trade payables to suppliers as of the quarter end.
- [assets](https://tickerbot.io/docs/signals/assets.md) (bigint) — Total assets on the balance sheet as of the most recently reported quarter.
- [book_value](https://tickerbot.io/docs/signals/book_value.md) (numeric) — Trailing-12m book value per share. Computed from `equity_attributable_to_parent / diluted_average_shares`.
- [cash_on_hand](https://tickerbot.io/docs/signals/cash_on_hand.md) (bigint) — Cash plus cash equivalents — the most-liquid balance-sheet line.
- [current_assets](https://tickerbot.io/docs/signals/current_assets.md) (bigint) — Assets expected to be converted to cash or used up within 12 months.
- [current_liabilities](https://tickerbot.io/docs/signals/current_liabilities.md) (bigint) — Liabilities due within 12 months — accounts payable, short-term debt, accrued expenses.
- [equity](https://tickerbot.io/docs/signals/equity.md) (bigint) — Total shareholders' equity.
- [equity_attributable_to_noncontrolling_interest](https://tickerbot.io/docs/signals/equity_attributable_to_noncontrolling_interest.md) (bigint) — Equity attributable to minority shareholders of consolidated subsidiaries. Usually 0 for non-conglomerates.
- [equity_attributable_to_parent](https://tickerbot.io/docs/signals/equity_attributable_to_parent.md) (bigint) — Equity attributable to the parent entity's shareholders (excludes minority interest).
- [fixed_assets](https://tickerbot.io/docs/signals/fixed_assets.md) (bigint) — Property, plant, and equipment (PP&E), net of accumulated depreciation.
- [inventory](https://tickerbot.io/docs/signals/inventory.md) (bigint) — Inventory on hand. NULL for service and financial companies that don't carry inventory.
- [liabilities](https://tickerbot.io/docs/signals/liabilities.md) (bigint) — Total liabilities on the balance sheet.
- [liabilities_and_equity](https://tickerbot.io/docs/signals/liabilities_and_equity.md) (bigint) — Total liabilities + total equity. Should equal `assets` (balance-sheet identity). Documented for completeness — useful as a sanity check rather than a scan target.
- [long_term_debt](https://tickerbot.io/docs/signals/long_term_debt.md) (bigint) — Long-term debt obligations. Often NULL because issuers fold this into `noncurrent_liabilities` instead of breaking it out.
- [noncurrent_assets](https://tickerbot.io/docs/signals/noncurrent_assets.md) (bigint) — Long-lived assets — property, plant, equipment, intangibles, long-term investments.
- [noncurrent_liabilities](https://tickerbot.io/docs/signals/noncurrent_liabilities.md) (bigint) — Liabilities due beyond 12 months — long-term debt, deferred taxes, pension obligations.
- [other_current_assets](https://tickerbot.io/docs/signals/other_current_assets.md) (bigint) — Current assets not separately broken out (prepaid expenses, short-term receivables, etc.).
- [other_current_liabilities](https://tickerbot.io/docs/signals/other_current_liabilities.md) (bigint) — Current liabilities not separately broken out.
- [other_noncurrent_assets](https://tickerbot.io/docs/signals/other_noncurrent_assets.md) (bigint) — Non-current assets not separately broken out (intangibles, deferred tax assets, etc.).

## Cash flow

Cash-flow-statement lines and free cash flow.

- [free_cash_flow](https://tickerbot.io/docs/signals/free_cash_flow.md) (bigint) — Operating cash flow minus capital expenditures. Cash the business generates above what it needs to maintain operations.
- [net_cash_flow](https://tickerbot.io/docs/signals/net_cash_flow.md) (bigint) — Sum of operating + investing + financing cash flow — period change in cash.
- [net_cash_flow_continuing](https://tickerbot.io/docs/signals/net_cash_flow_continuing.md) (bigint) — Total cash flow excluding discontinued operations. Rare line item — populated only for companies in active discontinued-ops winddown.
- [net_cash_flow_from_financing_activities](https://tickerbot.io/docs/signals/net_cash_flow_from_financing_activities.md) (bigint) — Net cash from financing (debt, dividends, buybacks).
- [net_cash_flow_from_financing_activities_continuing](https://tickerbot.io/docs/signals/net_cash_flow_from_financing_activities_continuing.md) (bigint) — Financing cash flow excluding discontinued operations.
- [net_cash_flow_from_investing_activities](https://tickerbot.io/docs/signals/net_cash_flow_from_investing_activities.md) (bigint) — Net cash from investing activities (capex, acquisitions). Negative for net spend.
- [net_cash_flow_from_investing_activities_continuing](https://tickerbot.io/docs/signals/net_cash_flow_from_investing_activities_continuing.md) (bigint) — Investing cash flow excluding discontinued operations.
- [net_cash_flow_from_operating_activities](https://tickerbot.io/docs/signals/net_cash_flow_from_operating_activities.md) (bigint) — Net cash from operations for the quarter.
- [net_cash_flow_from_operating_activities_continuing](https://tickerbot.io/docs/signals/net_cash_flow_from_operating_activities_continuing.md) (bigint) — Same as `net_cash_flow_from_operating_activities` but excludes discontinued operations.

## Margins & ratios

Ratios computed entirely from statement lines — margins, returns, liquidity, leverage. No market price in the formula.

- [current_ratio](https://tickerbot.io/docs/signals/current_ratio.md) (numeric) — Current assets ÷ current liabilities. Short-term liquidity. >1 = able to cover short-term obligations from current assets.
- [debt_to_equity](https://tickerbot.io/docs/signals/debt_to_equity.md) (numeric) — Total debt divided by total shareholders' equity. Common leverage ratio; lower = less leveraged.
- [gross_margin](https://tickerbot.io/docs/signals/gross_margin.md) (numeric) — `gross_profit / revenues` for the quarter.
- [operating_margin](https://tickerbot.io/docs/signals/operating_margin.md) (numeric) — `operating_income_loss / revenues` for the quarter.
- [operating_margin_ttm](https://tickerbot.io/docs/signals/operating_margin_ttm.md) (numeric) — Trailing-12m operating margin.
- [profit_margin](https://tickerbot.io/docs/signals/profit_margin.md) (numeric) — Net income ÷ revenue. Quarterly.
- [profit_margin_ttm](https://tickerbot.io/docs/signals/profit_margin_ttm.md) (numeric) — Trailing-12m profit margin.
- [quick_ratio](https://tickerbot.io/docs/signals/quick_ratio.md) (numeric) — (Current assets − inventory) ÷ current liabilities. Stricter liquidity — assumes inventory isn't quickly convertible.
- [return_on_assets](https://tickerbot.io/docs/signals/return_on_assets.md) (numeric) — Net income ÷ total assets. Quarterly figure.
- [return_on_assets_ttm](https://tickerbot.io/docs/signals/return_on_assets_ttm.md) (numeric) — Trailing-12m return on assets.
- [return_on_equity](https://tickerbot.io/docs/signals/return_on_equity.md) (numeric) — Net income ÷ shareholders' equity. Quarterly figure.
- [return_on_equity_ttm](https://tickerbot.io/docs/signals/return_on_equity_ttm.md) (numeric) — Trailing-12m return on equity.
- [high_margin](https://tickerbot.io/docs/signals/high_margin.md) (state) — Trailing-twelve-month profit margin is above 20%.
- [profitable](https://tickerbot.io/docs/signals/profitable.md) (classification) — Most-recently-reported quarter had positive net income.

## Valuation

Metrics crossing market price with financials — cap, EV, multiples, yield, beta — plus the size/style tags they own (cap tiers, beta tags, value_stock).

- [beta](https://tickerbot.io/docs/signals/beta.md) (numeric) — Trailing beta vs SPY. Null for issuers with insufficient price history.
- [cap_class](https://tickerbot.io/docs/signals/cap_class.md) (text) — Market-capitalization tier. One of `nano` (<$50M), `micro` ($50M–$300M), `small` ($300M–$2B), `mid` ($2B–$10B), `large` ($10B–$200B), `mega` (≥$200B), or `unknown` when `market_cap` is null. Updates daily post-close as `market_cap` moves. Preferred over the legacy `nano_cap/micro_cap/small_cap/mid_cap/large_cap/mega_cap` boolean columns (which remain in sync as backward-compat shortcuts).
- [dividend_yield](https://tickerbot.io/docs/signals/dividend_yield.md) (numeric) — Forward dividend yield as a fraction (0.025 = 2.5%). Null for non-payers.
- [enterprise_value](https://tickerbot.io/docs/signals/enterprise_value.md) (bigint) — Market cap + total debt − cash.
- [ev_to_ebitda](https://tickerbot.io/docs/signals/ev_to_ebitda.md) (numeric) — `enterprise_value` ÷ `ebitda`. Capital-structure-neutral profitability multiple.
- [ev_to_sales](https://tickerbot.io/docs/signals/ev_to_sales.md) (numeric) — `enterprise_value` ÷ `revenue_ttm`. Capital-structure-neutral revenue multiple.
- [forward_pe](https://tickerbot.io/docs/signals/forward_pe.md) (numeric) — Forward price-to-earnings ratio using next-12m consensus EPS. Lower = cheaper on forward basis.
- [market_cap](https://tickerbot.io/docs/signals/market_cap.md) (bigint) — Market capitalization. Updated daily; intraday change derived from `price` × `shares_outstanding`.
- [pe_ratio](https://tickerbot.io/docs/signals/pe_ratio.md) (numeric) — Price-to-earnings ratio (trailing twelve months). Null for unprofitable issuers.
- [peg_ratio](https://tickerbot.io/docs/signals/peg_ratio.md) (numeric) — PE ratio divided by EPS growth rate. Sparsely populated — PEG is only computed for tickers with positive earnings growth and analyst coverage.
- [price_to_book](https://tickerbot.io/docs/signals/price_to_book.md) (numeric) — Current price ÷ `book_value`. Common value-investing metric.
- [price_to_cash_flow](https://tickerbot.io/docs/signals/price_to_cash_flow.md) (numeric) — Current price ÷ operating cash flow per share. Less manipulable than P/E.
- [price_to_free_cash_flow](https://tickerbot.io/docs/signals/price_to_free_cash_flow.md) (numeric) — Current price ÷ `free_cash_flow` per share. Strictest cash-based valuation.
- [price_to_sales](https://tickerbot.io/docs/signals/price_to_sales.md) (numeric) — Current price ÷ `revenue_per_share_ttm`. Often used when companies have no earnings.
- [high_beta](https://tickerbot.io/docs/signals/high_beta.md) (classification) — Beta above 1.5: moves more than the market.
- [high_dividend_yield](https://tickerbot.io/docs/signals/high_dividend_yield.md) (classification) — Dividend yield above 4%.
- [large_cap](https://tickerbot.io/docs/signals/large_cap.md) (classification) — Market cap between $10B and $200B.
- [low_beta](https://tickerbot.io/docs/signals/low_beta.md) (state) — Beta below 0.5 — moves much less than the market.
- [mega_cap](https://tickerbot.io/docs/signals/mega_cap.md) (classification) — Market cap above $200B.
- [micro_cap](https://tickerbot.io/docs/signals/micro_cap.md) (state) — Market cap between $50M and $300M.
- [mid_cap](https://tickerbot.io/docs/signals/mid_cap.md) (classification) — Market cap between $2B and $10B.
- [nano_cap](https://tickerbot.io/docs/signals/nano_cap.md) (state) — Market cap below $50M.
- [small_cap](https://tickerbot.io/docs/signals/small_cap.md) (classification) — Market cap between $300M and $2B.
- [value_stock](https://tickerbot.io/docs/signals/value_stock.md) (classification) — Trades at a value-style P/E.

## Share structure & ownership

How the equity is divided and held: share counts, float and its tags, insider/institutional ownership, ETF holders.

- [basic_average_shares](https://tickerbot.io/docs/signals/basic_average_shares.md) (bigint) — Weighted-average basic shares outstanding for the quarter. Denominator for basic EPS.
- [diluted_average_shares](https://tickerbot.io/docs/signals/diluted_average_shares.md) (bigint) — Weighted-average diluted shares outstanding for the quarter. Denominator for diluted EPS.
- [etf_holders](https://tickerbot.io/docs/signals/etf_holders.md) (text[]) — ETFs that hold this ticker, ordered by the ticker's weight within each (the reverse of ETF holdings). Filter with array operators in /v2/scan, e.g. `'SPY' = ANY(etf_holders)` to find SPY constituents. Refreshed nightly post-close.
- [float_shares](https://tickerbot.io/docs/signals/float_shares.md) (bigint) — Public float (shares available to trade).
- [free_float_percent](https://tickerbot.io/docs/signals/free_float_percent.md) (numeric) — Percent of shares outstanding actually available for trading (excludes insider / restricted holdings).
- [percent_insiders](https://tickerbot.io/docs/signals/percent_insiders.md) (numeric) — Percent of shares held by company insiders (executives, directors, founders).
- [percent_institutions](https://tickerbot.io/docs/signals/percent_institutions.md) (numeric) — Percent of shares held by institutional investors (mutual funds, ETFs, pensions).
- [shares_outstanding](https://tickerbot.io/docs/signals/shares_outstanding.md) (bigint) — Total shares outstanding.
- [weighted_shares_outstanding](https://tickerbot.io/docs/signals/weighted_shares_outstanding.md) (bigint) — Weighted shares outstanding from the latest 10-Q / 10-K. Used by `market_cap = price × weighted_shares_outstanding`.
- [low_float](https://tickerbot.io/docs/signals/low_float.md) (classification) — Public float under 50 million shares.
- [ultra_low_float](https://tickerbot.io/docs/signals/ultra_low_float.md) (state) — Float below 5M shares — extremely thin supply.

## Short interest

Short positioning: readings, ratios, days-to-cover, and their flags.

- [days_to_cover](https://tickerbot.io/docs/signals/days_to_cover.md) (numeric) — Short interest divided by 30-day average daily volume. Trader’s "how many days of normal trading to cover all shorts" measure.
- [short_interest](https://tickerbot.io/docs/signals/short_interest.md) (bigint) — Raw shares-shorted count as last reported (FINRA bi-monthly). Pair with `short_interest_settlement_date` (profile.ts) for the as-of date.
- [short_interest_settlement_date](https://tickerbot.io/docs/signals/short_interest_settlement_date.md) (date) — Settlement date of the most recent short-interest report.
- [short_percent_of_float](https://tickerbot.io/docs/signals/short_percent_of_float.md) (numeric) — Short interest as a fraction of the free float. 0.10 = 10% of float is short.
- [short_volume_ratio](https://tickerbot.io/docs/signals/short_volume_ratio.md) (numeric) — Share of the day's volume executed as short sales (0–1).
- [high_short_interest](https://tickerbot.io/docs/signals/high_short_interest.md) (state) — More than 20% of the float is sold short.
- [short_volume_spike](https://tickerbot.io/docs/signals/short_volume_spike.md) (state) — More than 60% of the day's volume was executed as short sales.