Retrieve normalized US-GAAP financial statements (income statement, balance sheet, cash flow) for one company and fiscal year, from SEC EDGAR XBRL.

Identify the company by ticker OR cik. Use as_of (ISO YYYY-MM-DD) to get the figures as originally reported on that date — no look-ahead bias — for backtests. Set include_provenance=true to attach, for every value, the SEC accession, filed date, and a direct EDGAR source URL for citation. Set include_ratios=true for margins, ROA/ROE, and leverage derived from the same statements. Returns the normalized data object.

List a company's recent SEC filings (newest first) from the EDGAR submissions index — a lean company header plus filing rows.

Identify the company by ticker OR cik. Optionally filter by form (e.g. "10-K", prefix-matched so it includes amendments like "10-K/A") and cap the number of rows with limit (1-100). Use this to discover which fiscal years or filings are available before calling get_financials.

Retrieve normalized US-GAAP financials for MANY companies in one call — use this to compare peers or scan a set for a single fiscal year.

Pass companies as comma-separated tickers (e.g. "AAPL,MSFT,GOOGL") and/or ciks; up to 25 symbols total, all for the same year. as_of, include_provenance, and include_ratios behave as in get_financials and apply to every symbol. Each company returns its own result — either data or an error with a recovery hint — so one bad symbol never fails the batch. The whole call counts as a SINGLE request against your monthly quota, so prefer it over many get_financials calls when you need several companies.

Report the calling API key's current monthly quota: tier, monthly limit, requests used and remaining this billing month, and when it resets.

Free to call — it does NOT consume quota. Check it before a large batch or a long run so you can pace requests and avoid a hard rate-limit (429).