---
title: "Earnings trends"
method: GET
path: "/api/earnings/trends"
tags: ["Earnings"]
---

# Earnings trends

`GET /api/earnings/trends`

![Stock](https://img.shields.io/badge/Stock-f97316) ![Pro](https://img.shields.io/badge/Pro-8b5cf6)

Multi-year earnings analytics: compound annual growth rates (CAGR), margin trajectories with directional classification,
margin volatility, and earnings quality metrics. Computed from up to 12 years of annual SEC filing data.

This endpoint provides derived analytics that go beyond raw financial statements — margin trajectory direction
(expanding, compressing, stable), multi-year CAGR across revenue/net income/EPS/FCF, and quality ratios
like FCF-to-net-income and interest coverage.

## Query parameters

- `symbol` string
- `cik` integer
- `cusip` string
- `composite_figi` string
- `share_class_figi` string
- `currency` string

## Response `200`

Multi-year earnings trends and derived analytics. The EPS series feeding `eps3yr`/`eps5yr` CAGR is always split-adjusted so a stock split inside the window does not distort the growth rates.

- object
  - `symbol` string
  - `latestPeriod` string — Most recent fiscal period end date
  - `margins` object — Margin trajectories comparing current vs 3 years ago with directional classification
    - `gross` MarginTrajectory — Margin trajectory comparing current value vs 3 years ago with directional classification
      - `latest` number, nullable — Current margin percentage
      - `threeYearAgo` number, nullable — Margin percentage 3 years ago
      - `direction` 'expanding' | 'compressing' | 'stable', nullable — Directional classification based on ±1 percentage point threshold
    - `operating` MarginTrajectory — Margin trajectory comparing current value vs 3 years ago with directional classification
      - `latest` number, nullable — Current margin percentage
      - `threeYearAgo` number, nullable — Margin percentage 3 years ago
      - `direction` 'expanding' | 'compressing' | 'stable', nullable — Directional classification based on ±1 percentage point threshold
    - `net` MarginTrajectory — Margin trajectory comparing current value vs 3 years ago with directional classification
      - `latest` number, nullable — Current margin percentage
      - `threeYearAgo` number, nullable — Margin percentage 3 years ago
      - `direction` 'expanding' | 'compressing' | 'stable', nullable — Directional classification based on ±1 percentage point threshold
  - `netMarginStdDev` number, nullable — Standard deviation of net margins across all available history (percentage points). Lower = more predictable earnings.
  - `netMarginStdDevRecent` number, nullable — Standard deviation of net margins over the last 5 years (percentage points). Null if same as full history or insufficient data.
  - `historicalMaxNetMargin` number, nullable — Highest net margin ever recorded (percentage)
  - `cagr` object — Compound annual growth rates. Null if insufficient data for the requested window.
    - `revenue3yr` number, nullable — 3-year revenue CAGR (percentage)
    - `revenue5yr` number, nullable — 5-year revenue CAGR (percentage)
    - `netIncome3yr` number, nullable — 3-year net income CAGR (percentage)
    - `netIncome5yr` number, nullable — 5-year net income CAGR (percentage)
    - `eps3yr` number, nullable — 3-year EPS CAGR (percentage)
    - `eps5yr` number, nullable — 5-year EPS CAGR (percentage)
    - `freeCashFlow3yr` number, nullable — 3-year free cash flow CAGR (percentage)
  - `quality` object — Earnings quality metrics from the latest annual period
    - `fcfToNetIncome` number, nullable — Free cash flow / net income as a percentage. >100% = cash earnings exceed accrual earnings.
    - `interestCoverage` number, nullable — Operating income / interest expense. Higher = safer debt servicing.
    - `debtToOperatingIncome` number, nullable — Total debt / operating income. Lower = faster theoretical payoff.
    - `roe` number, nullable — Return on equity as a percentage

## Other responses

- `400` — Invalid parameters or symbol not found
- `403` — Feature not available on current plan

---

[API](https://skmtc.net/stockfit/apis/stockfit-api.md) · [All operations](https://skmtc.net/stockfit/apis/stockfit-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/stockfit/stockfit-api/revisions/3d5897270d8a/schema)