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
Related
- Asset hub: Stocks
- Symbols: AAPL, MSFT, NVDA, AMZN, GOOGL, META
- Docs: API reference: fundamentals
- Learn: Survivorship bias explained