Per-Share Data API

Retrieve per-share financial metrics for any publicly traded company. This endpoint normalizes key financial data points on a per-share basis, making it straightforward to compare companies of different sizes and to calculate custom valuation ratios.

Per-share data is fundamental to equity analysis. Earnings per share (EPS) drives the P/E ratio, book value per share drives P/B, and dividends per share is essential for income-focused investors. By providing these metrics pre-calculated with both basic and diluted share counts, this endpoint saves you from having to source share count data separately.

GEThttps://api.roic.ai/v2/fundamental/per-share/{identifier}

Parameters

Path Parameters

identifierstringrequired

Company identifier — supports ticker symbol (e.g., `AAPL`), CIK, CUSIP, or ISIN.

Example: AAPL

Query Parameters

apikeystringrequired

Your API key for authentication.

periodstringoptional

Reporting period for financial data.

Default: annualValues: annual, quarterly

limitnumberoptional

Maximum number of periods to return.

Default: 10Example: 10

fiscal_year_startnumberoptional

Filter results starting from this fiscal year.

Example: 2020

fiscal_year_endnumberoptional

Filter results ending at this fiscal year.

Example: 2024

date_startstringoptional

Filter results starting from this date (YYYY-MM-DD format).

Example: 2020-01-01

date_endstringoptional

Filter results ending at this date (YYYY-MM-DD format).

Example: 2024-12-31

orderstringoptional

Sort order for time-series data.

Default: DESCValues: ASC, DESC

formatstringoptional

Response format. Use `json` for JSON (default) or `excel` for tab-separated values compatible with Google Sheets and Excel.

Default: jsonValues: json, excel

Code Examples

curl "https://api.roic.ai/v2/fundamental/per-share/AAPL?apikey=YOUR_API_KEY"

Response

Response200 OK

[
  {
    "ticker": "AAPL",
    "date": "2025-09-30",
    "period": "annual",
    "period_label": "2025",
    "fiscal_year": "2025",
    "bs_sh_out": 14773260000,
    "is_sh_for_diluted_eps": 15004697000,
    "is_avg_num_sh_for_eps": 14948500000,
    "revenue_per_sh": 27.83964946315684,
    "ebitda_per_sh": 9.68311201792822,
    "oper_inc_per_sh": 8.900558584473359,
    "eps": 7.49305950429809,
    "eps_cont_ops": 7.49305950429809,
    "diluted_eps": 7.464995794316939,
    "dil_eps_cont_ops": 7.464995794316939,
    "div_per_shr": 1.0316085225942402,
    "cash_flow_per_sh": 7.457738234605479,
    "free_cash_flow_per_sh": 6.607151219185871,
    "cash_st_investments_per_sh": 3.6590293340468945,
    "book_val_per_sh": 5.305147673679634,
    "tang_book_val_per_sh": 4.932468140616115
  }
]

Field Dictionary

Field	Description
`bs_sh_out`	Shares outstanding
`is_sh_for_diluted_eps`	Diluted shares outstanding
`is_avg_num_sh_for_eps`	Average shares outstanding (basic)
`revenue_per_sh`	Revenue per share
`ebitda_per_sh`	EBITDA per share
`oper_inc_per_sh`	Operating income per share
`eps`	Earnings per share (basic)
`eps_cont_ops`	EPS from continuing operations
`diluted_eps`	Earnings per share (diluted)
`dil_eps_cont_ops`	Diluted EPS from continuing operations
`div_per_shr`	Dividends per share
`cash_flow_per_sh`	Cash flow per share
`free_cash_flow_per_sh`	Free cash flow per share
`cash_st_investments_per_sh`	Cash & short-term investments per share
`book_val_per_sh`	Book value per share
`tang_book_val_per_sh`	Tangible book value per share

Metadata

Field	Description
`ticker`	Ticker symbol
`date`	Period end date
`period`	Reporting period (annual/quarterly)
`period_label`	Human-readable period label
`fiscal_year`	Fiscal year

Use Cases

Calculate custom valuation ratios by combining per-share data with stock price data
Track EPS growth trends across quarters and years for earnings analysis
Build dividend analysis tools using dividends per share history
Create peer comparison tables normalized on a per-share basis
Power financial models that require per-share inputs for DCF or DDM calculations

Valuation Multiples - pre-calculated P/E, P/B, and other multiples
Income Statement - aggregate earnings and revenue data
Stock Prices - historical prices to pair with per-share metrics
Yield Analysis - yield metrics derived from per-share data