All statements as known on a date
snapshot_as_ofOne call that returns the income statement, balance sheet and cash flow statement of a company exactly as FinancialMD knew them on a date: no later restatements, no periods filed afterwards. This is the tool for point-in-time work: backtests, "what did an investor know on the day", reproducing a past model, or checking whether a decision was made on numbers that were later restated. Each statement carries its own meta; a statement the company does not have is reported as an error inside the snapshot rather than failing the whole call. The ratios computed from the same facts as known on that date ride along under ratios.
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": {
"as_of": "2023-06-30",
"limit": 4,
"company": "ticker:AAPL",
"period_type": "annual"
},
"name": "snapshot_as_of"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| as_of | Yes | The knowledge date to replay (YYYY-MM-DD or RFC 3339). Required. | |
| limit | No | Maximum number of periods or items to return (default 5, 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. | |
| period_type | No | Period basis: annual (fiscal years), quarterly, ltm (last twelve months) or ytd (year to date). | annual |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | as_of plus one grid per key (income_statement, balance_sheet, cash_flow and ratios: { statement, period_type, view, currency, periods, rows, meta }), or { error } for a grid that is not available. | |
| 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. |