Financials
Financial metrics snapshot
- Coverage
- US / CN / JP
- Billing
- 20 cr / thousand calls
Returns one row per ticker with market capitalization, enterprise value, TTM valuation multiples, margins, returns, growth rates and dividend metrics as of the latest snapshot date. Ratio fields are always decimals (0.25 = 25%), not percentages; amount fields are denominated in currency (the trading currency), and market_capitalization_usd is additionally converted to USD at the snapshot-date exchange rate.
- Metrics are precomputed values calculated from the snapshot date's close, not real-time data; the endpoint does not provide real-time or raw quotes (US market data is served by
/prices-snapshot, ; CN / JP have no market data endpoint). - The endpoint provides no forecast or estimate metrics; consensus price targets are served by
/analyst-consensus, EPS / revenue estimates by/earnings-calendar. - Certain metrics (
enterprise_value, dividend metrics) can benull, depending on per-company coverage.
Shared financials conventions
US / CN / JP, the last 3 years; markets out of scope return 404 . The three statement endpoints take the same parameters (ticker / period / limit) and return one row per period, aligned on (ticker, fiscal_year, period); for each ticker they return the most recent limit periods in descending report_period order. Valuation and derived financial metrics are provided separately by /financial-metrics-snapshot.
period: FY (default) / Q1–Q4 / H1. Accepts multiple comma-separated values. Periods actually disclosed per market: US FY Q1–Q3 (no standalone Q4 single-quarter figure), CN FY Q1 H1 Q3, JP FY H1 (no quarterly reports); a period that does not exist returns an empty array (Q4 is currently not disclosed separately in any of the three markets and is always an empty array; the caller computes fourth-quarter flow figures itself: US = FY − Q1 − Q2 − Q3, CN = FY − Q3 (Q3 is year-to-date cumulative), and JP has no quarterly figures; /balance-sheets holds point-in-time values, so no such subtraction applies). There is no date filter; limit counts back from the most recent period.
Common fields (present on every row of all three statements):
| Field | Type | Description |
|---|---|---|
ticker | string | Canonical ticker (US has no suffix, e.g. AAPL; CN is 600519.SH; JP is 7203.T) |
market | string | Market code: US / CN / JP |
fiscal_year | int | Fiscal year |
period | string | FY / Q1–Q4 / H1 |
period_start | date | Period start date; null for /balance-sheets |
report_period | date | Period end date |
currency | string | Reporting currency |
accounting_standard | string | US-GAAP / IFRS / CN-GAAP / JP-GAAP |
accession_number | string | Native document number from the official source: US is the SEC accession (e.g. 0000320193-25-000123), JP the EDINET docID, CN the cninfo announcement id |
form_type | string | Type of the source filing, in the market's native encoding (US: SEC form names such as 10-K / 10-Q; JP: EDINET numeric codes; CN: annual_report and the like) |
filing_url | string | Deep link to the official filing; opens the source document directly |
filing_date | date | Filing date: the date the document became public on the official channel |
Value conventions (common to all three statements):
- Field names are cross-market canonical line-item names; values are numbers in the base unit of
currency; line items that do not apply arenull. - Cash outflows are negative, inflows positive.
- Flow line items are as reported, no de-cumulation is applied, and the value corresponds to the
[period_start, report_period]range: US quarterly reports carry single-quarter figures; the CN third-quarter report (Q3) is year-to-date cumulative, the single-quarter figure =Q3−H1and the fourth quarter =FY−Q3; the semi-annual report (H1) is cumulative for the first half. - For derived line items (
ebitda/total_debt/net_debt/free_cash_flow), missing components count as 0; the value isnullonly when all components are missing. - Only GAAP / statutory-basis figures are returned; for non-GAAP numbers, use
/filing-search.
Query parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| ticker | string | required | Up to 50 tickers, comma-separated. |
Response fields
| Field | Type | Description |
|---|---|---|
| ticker | string | Canonical ticker (US has no suffix, e.g. AAPL; CN is 600519.SH; JP is 7203.T) |
| market | string | Market code: US / CN / JP |
| currency | string | Trading currency; the amount fields below are denominated in this currency |
| shares_outstanding | number | Shares outstanding |
| market_capitalization | number | Market capitalization in local currency |
| market_capitalization_usd | number | Market capitalization in USD, converted at the snapshot-date exchange rate |
| enterprise_value | number | Enterprise value in local currency |
| pe_ratio_ttm | number | Valuation multiple: P/E (TTM) |
| peg_ratio_ttm | number | Valuation multiple: PEG (TTM) |
| pb_ratio_ttm | number | Valuation multiple: P/B (TTM) |
| ps_ratio_ttm | number | Valuation multiple: P/S (TTM) |
| pcf_ratio_ttm | number | Valuation multiple: P/CF (TTM) |
| ev_to_sales_ttm | number | EV multiple: EV/Sales (TTM) |
| ev_to_ebitda_ttm | number | EV multiple: EV/EBITDA (TTM) |
| ev_to_ebit_ttm | number | EV multiple: EV/EBIT (TTM) |
| gross_profit_margin_ttm | number | Gross profit margin (TTM) |
| ebitda_margin_ttm | number | EBITDA margin (TTM) |
| net_income_margin_ttm | number | Net income margin (TTM) |
| fcf_margin_ttm | number | Free cash flow margin (TTM) |
| roe_ttm | number | Return ratio: ROE (TTM) |
| roa_ttm | number | Return ratio: ROA (TTM) |
| roic_ttm | number | Return ratio: ROIC (TTM) |
| revenue_growth_ttm | number | Revenue TTM year-over-year growth |
| eps_growth_ttm | number | EPS TTM year-over-year growth |
| fcf_growth_ttm | number | Free cash flow TTM year-over-year growth |
| revenue_cagr_3y | number | Revenue 3-year CAGR |
| eps_cagr_3y | number | EPS 3-year CAGR |
| dividend_yield_ttm | number | Dividend yield (TTM) |
| payout_ratio_ttm | number | Payout ratio (TTM) |
| dividend_growth_1y | number | 1-year dividend growth |
| consecutive_dividend_years | number | Consecutive years of dividend payments |
No key yet? Create one under API Keys — it is shown once, so store it where your shell can read it. Connecting an agent over MCP instead? That signs in through the browser and needs no key at all.
Authentication, conventions, rate limits and error shapes are the same for every endpoint — they live on REST API.