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.

Show how a company's reported figures for a fiscal year CHANGED across filings — as originally reported, then each restatement.

A company re-reports every fiscal year as a comparative in later filings, and when a number changes, that is a restatement. This returns the full series for each metric: every reported value with the date it was filed, the form (10-K/10-Q), the SEC accession and a direct EDGAR link, plus whether it was restated and by how much.

Use it to answer "has this been restated?", to show a figure's history, or to explain why a backtest on today's data would not match what an investor could have known at the time. Identify the company by ticker OR cik; narrow with metrics (comma-separated, e.g. "total_revenue,net_income") or omit for all. get_financials returns the LATEST reported figure; its as_of parameter returns the value as known on a date; this shows the whole series at once.

Find a company's ticker and CIK by ticker or company name.

Use this FIRST whenever you have a company name but not its ticker or CIK — every other tool needs one of those. Searches SEC's master list: "berkshire" returns BRK-B with its CIK, "mobil" returns XOM.

Ranked so the obvious answer wins (an exact ticker beats a company whose name merely contains the text). limit caps the number of matches (1-25).

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).