Standardized financial statement
financials_standardizedReturn one standardized statement (income statement, balance sheet, cash flow, or the supplemental statement with share counts and per-share figures) for a company, mapped to the FinancialMD concept template so line items are comparable across companies. Choose annual, quarterly, ltm or ytd periods and how many. Every cell is a value object with unit, currency, period, the known interval (when FinancialMD first and last knew this value), a restated flag and a proof that points at the filing, page and XBRL tag. as_of replays the statement as it was known on a date; original=true returns the first-reported version of each period; history=true returns every knowledge version of each period, oldest first, so restatements are visible. Use it for comparable statement numbers, trends over periods and the inputs of a model.
Example tool call
This call uses example arguments supplied in the tool’s input schema.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"limit": 5,
"company": "ticker:AAPL",
"statement": "income_statement",
"period_type": "annual"
},
"name": "financials_standardized"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| as_of | No | Knowledge date or timestamp (YYYY-MM-DD or RFC 3339). The answer is what FinancialMD knew at that instant: only facts whose known interval contains as_of. Omit for the current view. | |
| limit | No | Maximum number of periods or items to return (default 10, at most 200). | |
| company | Yes | Company identifier: a FinancialMD id ("fmd_01H..."), an SEC CIK ("cik:320193"), or a ticker ("ticker:AAPL", optionally with the MIC "ticker:AAPL.XNAS"). A bare ticker like "AAPL" is accepted and sent as ticker:AAPL. An issuer on an EU or UK regulated market that does not file with the SEC has no CIK: pass its LEI ("lei:IOG4E947OATN0KJYSD45") or its fmd_ id. | |
| history | No | Return every knowledge version of each period (oldest first). Mutually exclusive with original. | |
| original | No | Return the first-reported value of each period instead of the current one. | |
| statement | Yes | Which financial statement. supplemental carries share counts (outstanding, weighted average) and per-share figures. | |
| period_type | No | Period basis: annual (fiscal years), quarterly, semi_annual (half years: foreign filers that report on Form 20-F and furnish half-year figures on Form 6-K), ltm (last twelve months) or ytd (year to date). When a grid is empty, data.notes says why and meta.remedies names the calls that have rows. | annual |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | The standardized statement grid: periods (most recent first) and rows with cells aligned to them. | |
| meta | No | Request metadata: request_id, as_of, company resolution, coverage, pipeline_version, licence, terms, proof_base. | |
| error | No | Present only on isError results: the API error code and message plus remedy hints. |