One ratio as a series (daily for valuation)
ratios_dailyReturn one ratio as a series, most recent first. For a valuation ratio (market_cap, enterprise_value, pe_ttm, ps_ttm, pb, ev_ebitda_ttm, ev_ebit_ttm, fcf_yield, dividend_yield) there is one point per trading session: the IEX close of that day times the standardized facts known that evening (trailing twelve months for flows, the latest balance sheet), so a P/E series never uses a filing accepted later. Points are withheld after a split-sized move until split data exists; data.price_basis says which listing was used and why a company is not priced (several share classes such as BRK-A and BRK-B, an ADR, no prices). Each point is a value object whose proof.inputs lists the close first, then the facts; proof_get recomputes it. For a fundamentals ratio (gross_margin, roe, nii_to_avg_loans_securities...) there is one point per fiscal period of period_type. IEX is a single venue and its last trade is not the official close; say so when quoting. Use it for the history of one ratio, such as a P/E series or a margin trend.
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": 30,
"company": "ticker:AAPL",
"ratio_id": "pe_ttm"
},
"name": "ratios_daily"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | Valuation only: last session date, inclusive (YYYY-MM-DD). | |
| from | No | Valuation only: first session date, inclusive (YYYY-MM-DD). | |
| 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 30, at most 1000). | |
| cursor | No | Opaque cursor from a previous page (data.next_cursor). | |
| ticker | No | Valuation only: the listing whose close is used (default the primary listing with bars). | |
| 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. | |
| ratio_id | Yes | Ratio id. Valuation ids give a daily series; the others one point per period. | |
| 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 | { ratio_id, label, formula, metric_format, period_type ("daily" for valuation), view, items: [value objects], next_cursor, price_basis?: { listing, source, unavailable } } | |
| 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. |