Early access is open. Free sample datasets are live now. Download a sample

Data product · Early access

Stock Fundamentals API: Financial Statements and Ratios

Revenue, earnings, balance sheet and cash flow for US companies, straight from SEC filings, with the date each number was filed so your backtest only sees what was public at the time.

Coverage

What you get

Item Detail
Product code STK-FUNDAMENTALS
Coverage US companies that file with the SEC
Granularity Quarterly, annual and trailing twelve months, plus derived ratios
History Free: latest 4 quarters. Starter and up: full EDGAR XBRL history, which starts in 2009
Delivery REST API, CSV and JSON files
Update speed Daily, as new filings land on EDGAR

The data is long format, one fact per row, which is what lets us carry filed_date and accession_number on every single number. A wide view (one row per company per period) is available as a response format on the same data.

Schema

Schema

Field Type Required Description
symbol string yes Our ticker
cik string yes SEC Central Index Key
metric string yes Standard name, e.g. revenue, net_income, eps_diluted, total_assets, total_liabilities, shareholders_equity, cash_and_equivalents, operating_cash_flow, ebitda, gross_profit, operating_income, shares_outstanding
statement string yes income, balance_sheet, cash_flow, ratio, valuation
fiscal_year number yes Company fiscal year
fiscal_period string yes Q1 to Q4, FY, TTM
calendar_period string optional e.g. CY2026Q3 (I suffix = instant, for balance sheet items)
period_start string optional Start date for duration metrics; null for balance sheet
period_end string yes Period end date
value number yes Reported value
unit string yes USD, USD/share, shares, ratio
form string yes Source form, 10-K, 10-Q, 20-F
filed_date string yes Filing date (point-in-time key, avoids look-ahead bias)
accession_number string yes SEC accession number
is_restated boolean optional True if a later filing changed the value
xbrl_tag string optional Original XBRL tag, e.g. us-gaap:Revenues

Example record:

{
  "symbol": "AAPL",
  "cik": "0000320193",
  "metric": "revenue",
  "statement": "income",
  "fiscal_year": 2026,
  "fiscal_period": "Q4",
  "calendar_period": "CY2026Q3",
  "period_start": "2026-06-28",
  "period_end": "2026-09-26",
  "value": 102466000000,
  "unit": "USD",
  "form": "10-K",
  "filed_date": "2026-10-31",
  "accession_number": "0000320193-26-000105",
  "is_restated": false,
  "xbrl_tag": "us-gaap:RevenueFromContractWithCustomerExcludingAssessedTax"
}

Sample data

Sample data

This one is real. The free sample covers 8 large caps (AAPL, MSFT, NVDA, AMZN, GOOGL, META, TSLA and JPM) since 2023: revenue, net income, diluted EPS, assets, liabilities, equity, cash and cash flow. It has 865 rows. Here are the first 10:

symbol metric calendar_period period_start period_end value unit form filed_date accession_number
AAPL cash_and_equivalents CY2023Q1I 2023-04-01 24687000000 USD 10-Q 2023-05-05 0000320193-23-000064
AAPL eps_diluted CY2023Q1 2023-01-01 2023-04-01 1.52 USD/share 10-Q 2024-05-03 0000320193-24-000069
AAPL net_income CY2023Q1 2023-01-01 2023-04-01 24160000000 USD 10-Q 2024-05-03 0000320193-24-000069
AAPL revenue CY2023Q1 2023-01-01 2023-04-01 94836000000 USD 10-Q 2024-05-03 0000320193-24-000069
AAPL shareholders_equity CY2023Q1I 2023-04-01 62158000000 USD 10-Q 2024-08-02 0000320193-24-000081
AAPL total_assets CY2023Q1I 2023-04-01 332160000000 USD 10-Q 2023-05-05 0000320193-23-000064
AAPL total_liabilities CY2023Q1I 2023-04-01 270002000000 USD 10-Q 2023-05-05 0000320193-23-000064
AAPL cash_and_equivalents CY2023Q2I 2023-07-01 28408000000 USD 10-Q 2023-08-04 0000320193-23-000077
AAPL eps_diluted CY2023Q2 2023-04-02 2023-07-01 1.26 USD/share 10-Q 2024-08-02 0000320193-24-000081
AAPL net_income CY2023Q2 2023-04-02 2023-07-01 19881000000 USD 10-Q 2024-08-02 0000320193-24-000081

Source: SEC EDGAR

The sample file has the core columns. The full API adds cik, statement, fiscal_year, fiscal_period, is_restated and xbrl_tag.

Use cases

Use cases

Point-in-time factor backtests. Join fundamentals to prices on filed_date, not period_end. Apple's quarter ending 1 April 2023 wasn't public until the 10-Q came out in May, and a backtest that uses it on 2 April is cheating.

Restatement checks. Look at the sample: AAPL's CY2023Q1 EPS row comes from a 2024 filing, where it appeared as the prior-year comparison. When a later filing changes a number, is_restated flags it, and you choose between as-first-reported and latest values.

Quality screens. net_income over shareholders_equity gives ROE; total_liabilities over total_assets gives leverage. Compute them yourself or read the ratio statement rows.

Code

Code examples

Example: quarterly revenue and net income for AAPL.

curl "https://api.marketdata.co/v1/stocks/fundamentals?symbol=AAPL&metric=revenue,net_income&fiscal_period=Q1,Q2,Q3,Q4" \
  -H "Authorization: Bearer $MARKETDATA_API_KEY"

Example: load the free sample in pandas and pivot it wide.

import pandas as pd

df = pd.read_csv("us-company-financials.csv", parse_dates=["period_end", "filed_date"])
eps = df[df["metric"] == "eps_diluted"]
wide = eps.pivot_table(index="calendar_period", columns="symbol", values="value")
print(wide.tail())

Pricing

Pricing

Plan Fundamentals
Free, $0 Last 4 quarters for any US company
Starter, $29/mo Full EDGAR history from 2009, TTM and ratios
Business, $249/mo Commercial use

A full US fundamentals file (all companies, all periods, long format) is planned at $199 one-off. Single-company files are free. Prices are early access and may change.

Among the vendors we studied, paid plans with fundamentals run from $9.99 to $299 a month, median $69.50. Three of them have a free tier.

Side by side

How we compare

20 of the 50 providers we studied sell financial statements. Most give you the latest restated figure with no filing date, which is fine for a stock page and bad for a backtest. We publish the price, keep the filing metadata on every row, and the data comes from EDGAR, which is public domain, so you can do what you like with the files you buy.

FAQ

Frequently asked questions

Where does the data come from?

SEC EDGAR, using the XBRL facts companies file with their 10-K and 10-Q reports. Every row links back to its filing through accession_number.

What does the I suffix in calendar_period mean?

It marks an instant value, such as a balance sheet item measured on one date. Those rows have no period_start.

Are values adjusted for stock splits?

EPS and share counts are reported as filed. If a company later restates them after a split, the restated value arrives in a newer filing and is_restated is set.

Do you cover non-US companies?

Only those that file 20-F reports with the SEC, at launch. Wider global coverage is on the roadmap as an add-on.

Can I use the free sample commercially?

Yes. EDGAR data is a US government work in the public domain. We ask for the credit line "Source: SEC EDGAR".

Keep reading