Valuein — SEC EDGAR Fundamentals & Smart-Money Data

Returns a company's reported figures for two fiscal periods side by side, with each figure's absolute and percentage change, a significance label (minor under 5%, notable 5 to 15%, significant over 15%) and a count of material changes. Use this when the user asks how a company changed between two years or quarters. Periods given in reverse order are swapped and the result says so.

Returns whether a proposed acquisition raises or lowers the acquirer's earnings per share in the first year after the deal, with deal value, new shares and debt, pro forma net income, shares and EPS, and the takeover premium, from both companies' latest annual 10-K figures and month-end closing prices. Use this when the user asks whether a deal would be accretive or dilutive at an offer price, cash and stock mix and synergies they choose. It covers one year only: synergy ramp, integration costs and purchase accounting are not modelled.

Returns a two-stage discounted cash flow value per share in US cents, with enterprise and equity value, the terminal value's share and a 5 by 5 sensitivity grid over discount rate and terminal growth, built from the company's latest free cash flow, net debt and share count and the growth and discount rates given. Use this when the user asks what a company could be worth under stated assumptions. A null value means the inputs leave the model undefined, and the reason field says why.

Returns the sponsor's multiple of invested capital and internal rate of return for a leveraged buyout, with entry and exit enterprise value, debt, equity and a yearly projection, on an opening balance sheet built from the deal terms and the company's latest annual 10-K operating figures. Use this when the user asks what a buyout could return under stated purchase and exit multiples, leverage and hold period. EBITDA is approximated by operating income unless an entry figure is given, and a null rate means no rate fits the cash flows.

Returns the definitions of the dataset's tables: each table's description and its columns. Use this when the user asks what a field in another result means or which fields the data holds.

Returns forensic accounting scores from a company's two latest annual filings: a partial Beneish M-score (sales growth, total accruals and leverage growth), Sloan accruals, debt to equity, debt to assets and return on assets, and plain-language red flags, with the source filing. Use this when the user asks about earnings quality or accounting risk. The M-score is partial because some of its inputs are not in the dataset, and the result marks it so.

Returns, for each fiscal year from annual 10-K filings, operating cash flow, capital expenditures, free cash flow, R&D, acquisitions and divestitures, dividends, buybacks, debt issued and repaid, each use as a share of operating cash flow, and flags such as buybacks or total payouts exceeding free cash flow. Use this when the user asks where a company's cash goes or whether its payouts exceed its free cash flow.

Returns reported figures from a company's 10-K or 10-Q filings by period: revenue, gross profit, operating income, net income, diluted EPS, total assets, liabilities, equity, cash, short-term investments, debt, operating cash flow, capital expenditures and shares outstanding, each tied to its source filing. Use this when the user asks what a company reported. It covers current and former S&P 500 companies over the most recent five fiscal years; margins and multiples come from `get_valuation_metrics`.

Returns, by fiscal period, reported EPS and revenue, revenue growth year over year, a trend EPS estimate built from the company's own past EPS and the gap between actual and trend, plus 1, 3, 6 and 12-month price momentum and the 52-week high and low. Use this when the user asks about a company's earnings trajectory or price momentum. The trend estimate is not analyst consensus, so the gap is not a beat or miss against forecasts.

Returns a company's computed ratios by period, annual and trailing twelve months, in groups: profitability, liquidity, leverage, efficiency, per share, owner earnings, forensic, growth, sector rank and valuation, each with value, unit and a reason when missing. Use this when the user asks for a company's ratios or how they changed over time. It covers current and former S&P 500 companies over the most recent five fiscal years; ranking against other companies comes from `screen_universe`.

Returns a company's latest ratios beside those of up to 10 peers from the same SIC industry, closest code match first and S&P 500 members preferred, using trailing twelve months where available. Use this when the user asks how a company compares with its competitors. It covers current and former S&P 500 companies, so peers come from that set.

Returns the companies in the S&P 500, a Russell index or a sector on a given date, including members that later left or delisted, with CIK, ticker, name, sector, industry and a confidence label, plus the full member count. Use this when the user asks who was in an index on a past date or whether a company was a member then. It covers current and former S&P 500 companies, and a long list arrives in pages of at most 250 rows.

Returns a company's month-end closing prices over a date range, oldest first, one bar per completed month with the unadjusted close in USD, dividend cash, split factor and a total-return index; open, high, low and volume are empty. Use this when the user asks how a stock's price or total return moved over months or years. Closes are not split-adjusted, so the return between two dates is the ratio of their total-return index values minus one.

Returns a company's SEC filings, newest first, each with form type, filing and report dates, accession number and links to the EDGAR index page, the filing document and the inline XBRL viewer. Use this when the user wants the original 10-K, 10-Q, 8-K, 20-F or 40-F filings behind the numbers. Filings cover the most recent five fiscal years; to trace one figure to its filing, `verify_fact_lineage` fits.

Returns one of a company's month-end closing prices: the unadjusted close in USD on the last trading day of the latest completed month on or before a date, with the dividend and split factors and a total-return index. Use this when the user asks what a stock traded at around a date. The month in progress is not included; a run of month-ends comes from `get_price_history`.

Returns, by fiscal period, margins, return on equity, assets and invested capital, free cash flow and its margin, debt to equity, market multiples at period end (price, market cap, P/E, P/B, EV/EBITDA, dividend yield) and two assumption-free reference values, the Graham number and net current asset value per share. Use this when the user asks what a company trades at or how profitable it is. An intrinsic value under stated assumptions comes from `compute_dcf`.

Returns restatement events: reported figures that a later SEC filing changed by more than 0.5%, each with the original and restated values, the change, a severity, the XBRL tag, both filings' accession numbers and how it was disclosed (non-reliance 8-K, amended filing, or a routine filing). Use this when the user asks whether or how a company's past numbers were revised. A revision in a routine filing describes the filing record, not the company's intent.

Returns a linked income statement, balance sheet and cash flow for each projected year, seeded from the company's latest annual 10-K figures, with a yearly check that the balance sheet balances and the free cash flow stream. Use this when the user wants to see how a company's statements could develop under growth, margin, financing and payout assumptions they choose. Margins and capital spending stay at the latest year's share of revenue unless overridden; interest and tax rates are the user's assumptions.

Returns companies ranked by factor scores: return on equity, gross, operating and net margin, revenue growth, free cash flow to assets, debt to equity, asset turnover, current ratio and Piotroski F-score, each with a percentile rank from 0 (worst) to 1 (best), plus a composite rank. Use this when the user wants companies ranked or filtered by quality or growth, or where one company ranks. It covers current and former S&P 500 companies; one company's ratios over time come from `get_financial_ratios`.

Returns companies matching a name, ticker, CIK or SIC code, with CIK, ticker, name, sector, industry, exchange, listing status and current S&P 500 membership. Use this when the user names a company and other tools need its ticker or CIK, or asks for current S&P 500 members. It covers current and former S&P 500 companies; membership on a past date comes from `get_pit_universe`.

Returns one reported figure with its source: company, concept, value, unit, period, form type, filing date, accession number and links to the filing on SEC EDGAR. Use this when the user asks which filing reported a number, by fact_id from an earlier result or by concept for the latest value. A figure from a specific period is traced by the fact_id `get_company_fundamentals` returns for it, and many fact_ids at once by `verify_facts`.

Returns, for up to 50 fact_ids in one call, each figure's source filing or a not-found code and message, plus counts of requested, found and missing. Use this when the user wants a list of cited figures checked against SEC filings. Duplicate pairs are checked once, and a lookup by concept rather than fact_id comes from `verify_fact_lineage`.