Datavidence Financials

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.

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.

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

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.

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