Inside the StockFit Company APIs: A Deep Dive

The StockFit Company APIs cover everything you need to research a US-listed business straight from its SEC filings: who it is, what it sells, how it makes money, what its numbers look like over time, who owns it, and what insiders are doing with their shares. To make this concrete, this post walks through each endpoint group with one ticker as the canvas: Apple Inc. (AAPL). Every number below is a real response from the live API, every section links back to its Swagger docs, and a short “ideas to build with this” section closes the tour.

1. Who is the company?

The starting point. Company Details returns the cleaned profile: legal name, CIK, SIC industry, sector, fiscal-year-end, exchange listings, IR website, and a markdown business overview. It is the first call most integrations make because every other endpoint can be addressed by the same cik or symbol.

Notice the fiscal year end: September 26, not December 31. Apple, Costco (August), and many others run non-calendar fiscal years — every downstream financial endpoint already handles this correctly so the “FY2025” label is the company's own definition, not a calendar approximation.

2. Five years of income

Income Statement returns normalized line items — revenue, cost of revenue, gross profit, R&D, SG&A, operating income, EBITDA, net income, EPS basic and diluted — mapped from raw XBRL to a curated set of standardized concepts. Pass period=annual, quarter, or ttm.

The arc is visible in five rows: the FY2023 dip ($383B revenue, down from FY2022), two recovery years, and a fresh high in FY2025 of $416B revenue and $112B net income. Every line traces back to the underlying 10-K filing — the response includes a sources map listing exactly which accession number each fact came from.

3. Year-over-year growth rates

Computing growth is mechanical, but doing it correctly across non-calendar fiscal years and reconstructed Q4s is fiddly. Growth handles both, returning year-over-year deltas for revenue, gross profit, operating income, net income, EPS, EBITDA, free cash flow, total assets, equity, and operating cash flow.

Read FY2025 closely: revenue grew +6.4%, but net income jumped +19.5% and EPS jumped +22.6%. The wedge between revenue growth and EPS growth is operating leverage plus the buyback effect — we'll see that show up explicitly in the EPS history endpoint below.

4. Multi-year CAGRs and margin direction

For longer-horizon analysis, Earnings Trends returns 3-year and 5-year CAGRs for revenue, net income, EPS, and free cash flow, plus a margin-direction classification (expanding, stable, contracting) computed against a 3-year-ago baseline.

Two facts that are immediately useful: (1) all three margin tiers are expanding over a 3-year window, and (2) the 5-year EPS CAGR (17.7%) is roughly double the revenue CAGR (8.7%). The gap is the buyback flywheel — share count is the missing variable.

5. Sector-aware key metrics

Key Metrics returns three blocks per period: general (40+ ratios every company has — margins, returns, leverage, liquidity, per-share, turnover), sectorMetrics (a metric pack tailored to the company's SIC-derived sector), and industryMetrics (a deeper pack for eight specialized industries).

General — profitability & returns (FY2025)

That 171% ROE looks impossible for a hardware company. It is real, and the explanation lives one endpoint away on the balance sheet — nine years of buybacks have shrunk Apple's equity base so aggressively that the denominator is tiny relative to net income. We'll see the mechanism on the next endpoint.

Sector pack — manufacturing-specific (FY2025)

The cash conversion cycle is negative 71.8 days. Apple collects from customers in 32 days, holds inventory for 11 days, and takes 115 days to pay its suppliers. In effect, suppliers are financing Apple's working capital. That single number reframes how you think about the cash-generating engine of the business — and it's the kind of insight that lives in the sector pack, not the general one, because it depends on having receivables, payables, and inventory all in the same response.

6. Balance sheet

Balance Sheet returns assets, liabilities, equity, debt, cash, and working capital exactly as filed. Three years of history makes the buyback story land.

Look at the retained earnings column: it has been negative for years. That isn't accumulated losses — Apple is wildly profitable. It's the result of returning more cash to shareholders than the company has accumulated in retained earnings since inception. FY2025 alone saw $89.3B in buybacks and $15.4B in dividends (we'll see this in the economic model below). Equity stays small, so ROE explodes.

7. Earnings snapshot & EPS history

Earnings Snapshot is a one-call executive summary of the most recent fiscal year — EPS, margins, returns, FCF, growth, the Piotroski F-score, and predicted next earnings/filing dates. EPS History returns the per-period EPS series with share counts, so you can see exactly how buybacks compound into EPS.

Diluted share count fell from 16.86B to 15.00B over five years — an 11% reduction. Combined with FY2025's net-income jump, that's how a 6.4% revenue increase translates into a 22.6% EPS increase. The next predicted earnings date in the snapshot response: 2026-04-30.

8. Financial health scores

Scores returns the Piotroski F-Score (0–9) with the per-criterion breakdown, plus the Altman Z-Score where applicable. Both are standard academic measures of fundamental quality.

Eight of nine criteria pass — a strong reading on a backward-looking quality lens. The granular breakdown is what makes this useful in code: instead of a single score, you can branch on which specific dimensions a company fails (e.g. screen for “rising ROA AND no dilution AND rising gross margin”).

9. The audit-grade economic model

This is where StockFit goes well past stock-screener territory. The Economic Model is a structured, AI-assembled, citation-verified breakdown of how a business actually works. Every claim ships with a verbatim quote pulled from the 10-K (with the section it came from), so an LLM consuming this endpoint never has to guess. Each block is also exposed individually for narrower queries: business model, offerings, operating levers, competitive advantages, flywheels, strategic initiatives, failure modes, and peers.

Product & service portfolio

Ten offerings, each tagged with its monetization model and margin profile. Notice the clean split: hardware is “mid” margin and one-time, services are “high” margin and recurring. The economic model captures this without you having to read the 10-K.

Structural advantages (moats)

Ecosystem flywheel

Strategic initiatives (2025–2026)

These three initiatives didn't come from a press release roundup — they were extracted from the FY2025 10-K's Risk Factors and MD&A sections, with the exact 10-K passages preserved as citations in the API response. That citation discipline is what audit-grade means in practice.

Capital allocation

What could go wrong

10. Peer landscape

Sourced from the same audit-grade economic model. Each peer entry includes the relationship type, a short rationale, the comparable segments to focus on, and explicit guidance on what not to compare on (because hardware-vs-cloud margin comparisons mislead more often than they help).

The model also returns a comparisonFramework.doNotCompareOn field, which for AAPL flags “total unit shipments without ASP normalization” and “overall operating margin vs hardware-only peers.” Useful guardrails when programmatically constructing comparisons.

11. Ownership

Ownership Summary aggregates 13F filings into the institutional ownership picture: total holder count, percent of shares outstanding, top holders, and the largest quarter-over-quarter movers in both directions.

Apple has 5,302 institutional holders reporting 57.3% of shares outstanding (8.4B shares, ~$2.14T in reported value, as of 2025-12-31).

The endpoint also surfaces QoQ movers: AllianceBernstein increased its position by 39.9%, Capital International by 28.2%, and Capital Research Global Investors by 21.7%. On the sell side, Barclays cut its position by 39.3% (-22.6M shares). Useful for tracking smart-money flow at a point-in-time granularity that 13F filings make possible.

12. Insider activity

Insider Summary aggregates Form 3/4/5 filings over rolling 3-, 6-, and 12-month windows. Buys vs sells, share counts, dollar values, and unique-actor counts — everything you need for an oversight or signal layer without writing the aggregation yourself.

Zero insider buys across all three windows, with $112.8M of selling spread across six unique sellers over twelve months. For a company at AAPL's scale, this is the typical pattern of executives monetizing planned vesting through 10b5-1 programs — the absence of buys is informative on its own.

What you can build with this

Twelve endpoints, one ticker. Compose them and the surface area is large. A few small ideas to make this concrete:

The bottom line