GET /v1/statistics

GET /v1/statistics

Returns a snapshot of the most-watched fundamental ratios and figures for a single symbol. Roughly equivalent to a “key statistics” page on a retail finance site. See fundamentals for refresh policy and source priority.

Request

GET /v1/statistics?symbol=AAPL HTTP/1.1
Host: api.oneapi.finance
Authorization: Bearer oa_live_<your_key>

Query parameters

Param	Type	Required	Notes
symbol	string	yes	Single symbol.
exchange	string	no	Disambiguate cross-listed tickers.

Response

{
  "marketCap": 2750000000000,
  "enterpriseValue": 2810000000000,
  "trailingPe": 28.4,
  "forwardPe": 26.1,
  "pegRatio": 2.1,
  "priceToSales": 7.2,
  "priceToBook": 42.5,
  "profitMargin": 0.252,
  "operatingMargin": 0.298,
  "roe": 1.452,
  "roa": 0.218,
  "revenueTtm": 385000000000,
  "eps": 6.18,
  "ebitda": 130000000000,
  "beta": 1.27,
  "fiftyTwoWeekHigh": 198.23,
  "fiftyTwoWeekLow": 124.17,
  "fiftyDayMa": 174.21,
  "twoHundredDayMa": 168.45,
  "sharesOutstanding": 15670000000,
  "dividendYield": 0.0055,
  "payoutRatio": 0.155,
  "exDividendDate": "2026-02-09"
}

Field reference

Grouped by category. All fields are nullable; small caps and pre-IPO names typically have many null values. The wire-format model is oneapi_core.responses.statistics.StatisticsResponse.

Valuation

Field	Type	Notes
marketCap	number | null	In source currency. price × sharesOutstanding.
enterpriseValue	number | null	marketCap + debt - cash.
trailingPe	number | null	price / EPS_TTM. Negative when EPS is negative.
forwardPe	number | null	Based on consensus next-12-month EPS.
pegRatio	number | null	Forward P/E divided by 5-year forecast growth.
priceToSales	number | null	marketCap / revenueTtm.
priceToBook	number | null	marketCap / book value.

Profitability

Field	Type	Notes
profitMargin	number | null	TTM net income / TTM revenue. Fractional rate (0.252 = 25.2%).
operatingMargin	number | null	TTM operating income / TTM revenue.
roe	number | null	TTM net income / average shareholders’ equity.
roa	number | null	TTM net income / average assets.
revenueTtm	number | null	Trailing twelve months revenue, source currency.
eps	number | null	Diluted EPS, TTM.
ebitda	number | null	Earnings before interest, taxes, depreciation, amortization. TTM, source currency.

Stock statistics

Field	Type	Notes
beta	number | null	5-year monthly returns vs S&P 500.
fiftyTwoWeekHigh	number | null
fiftyTwoWeekLow	number | null
fiftyDayMa	number | null	Simple moving average.
twoHundredDayMa	number | null	Simple moving average.
sharesOutstanding	number | null	Most recent reported figure.

Dividends

Field	Type	Notes
dividendYield	number | null	Trailing 12-month dividends / price. Fractional rate (0.0055 = 0.55%).
payoutRatio	number | null	TTM dividends / TTM EPS.
exDividendDate	string | null	ISO date of most recent ex-dividend.

Examples

curl

curl -H "Authorization: Bearer oa_live_..." \
  "https://api.oneapi.finance/v1/statistics?symbol=AAPL"

Python

import httpx, os

r = httpx.get(
    "https://api.oneapi.finance/v1/statistics",
    params={"symbol": "AAPL"},
    headers={"Authorization": f"Bearer {os.environ['ONEAPI_KEY']}"},
    timeout=10.0,
)
r.raise_for_status()
stats = r.json()
print(f"AAPL P/E = {stats['trailingPe']}")

JavaScript

const r = await fetch(
  "https://api.oneapi.finance/v1/statistics?symbol=AAPL",
  { headers: { Authorization: `Bearer ${process.env.ONEAPI_KEY}` } },
);
const stats = await r.json();
console.log(`AAPL P/E = ${stats.trailingPe}`);

Errors

Status	code	When
401	unauthenticated	Missing or invalid API key.
404	not_found	Symbol unknown.
429	rate_limit	See rate limits.
502	upstream_failure	All sources failed.

See also

• Fundamentals concept — sources and refresh cadence.
• Fundamentals screener guide — building a screener.
• GET /v1/profile — sector, industry, identifiers.