Standardized financial statements, metrics, ratios, and factors API

What is in it

• ·Standardized financial statements across four Regulation S-X schemas, classified and re-spread for analytics
• ·Precomputed metrics and ratios as per-company time-series
• ·60+ point-in-time factors and composite scores (Altman Z, Piotroski F, Beneish M), sector-aware and NULL-faithful
• ·Every factor ships with a percentile rank within its sector and period cohort
• ·Full version history: the original filing, amendments, and restated comparative columns are all preserved

Endpoints

11 endpoints on https://api.3spread.com. Full parameters and response schemas are in the API reference.

Query it

Every dataset is available on the free Community tier. Sign up, provision a key, and query it. No credit card.

curl "https://api.3spread.com/v1/financials?limit=10" \
  -H "apikey: $THREESPREAD_API_KEY"

from py3spread import Client

client = Client()  # reads THREESPREAD_API_KEY
page = client.financials.list(limit=10)

for row in page["data"]:
    print(row)

What people build with it

• ·Backtest with point-in-time factors that never leak future information
• ·Screen the universe cross-sectionally with percentile-ranked metrics
• ·Build comparable panels across filers without manual cleanup

Guides using this dataset

• Pull standardized financial statements in Python

  Query a company's income statement, balance sheet, and cash flow from the API as a clean, consistent grid, no matter how the filer tagged it. About 40 lines of Python on a free key.

• Screen companies by factor scores in Python

  Pull 90 point-in-time factors with percentile ranks for a single company, then run a cross-company screen sorted by any factor. About 40 lines of Python on a free key.

The other datasets

All of them are included, free, on the same key.