Compare a figure across companies
compare_companiesOne standard figure for two to ten companies side by side: revenue, net income, EPS, operating income, free cash flow, debt, cash, equity or any other standard figure listed in get_figure. Defaults to each company's latest discrete period (its latest quarter, or its latest fiscal year if that is newer); pass period='latest annual', 'ttm', 'latest quarter' or a fiscal year. Fiscal calendars differ between companies, so each row states its own period and dates, and the field it was read from; a company that does not report the figure, or the period, gets a row saying so rather than failing the call. All money is in actual dollars (not thousands, not millions), per-share figures in dollars per share (per ADS for a foreign issuer that has one), share counts in actual shares, split-adjusted. A foreign issuer's figures are converted to US dollars at the rate recorded on each period.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| figure | Yes | A standard figure name or synonym, e.g. revenue, net income, diluted eps, fcf. | |
| period | No | Default 'latest'. Fiscal year: 'FY2025', 'FY25', 'fiscal 2025' or '2025'. Quarter: 'Q2 FY2027', 'Q2 2027', 'FY27Q2', '2027Q2', '2Q27', 'second quarter 2027', or 'Q2' for the latest second quarter. Special: 'latest' (most recent period of any kind), 'latest quarter', 'latest annual', 'ttm' (trailing twelve months), 'ytd' (year to date), 'prior ytd', 'annual' (every fiscal year), 'quarterly' (every quarter), 'all' (every period in every published record). A period-end date such as '2026-07-26' also works. | |
| tickers | Yes | Two to ten tickers. |