Operating Metrics (per-company KPIs in the industry-standard set — cruise; SIC-routed)
operating_metricsA company's operating-KPI time series in the metric set standard for its industry — the structured operating depth a model can't reliably pull from a 10-K itself. You pass a company (ticker/CIK) and get THAT company's values (per-company, not industry aggregates), from MARS's KPI panel extracted from 10-Q / 10-K text.
Covered industries: cruise lines (occupancy, passenger cruise days, APCDs, fuel cost per ton, net cruise costs), P&C insurers (combined / loss / expense ratios, premiums written and earned), homebuilders (net orders, closings, backlog, average selling price, cancellation rate, active communities) and airlines (ASMs, RPMs, load factor, TRASM / PRASM / CASM, yield). The response's industry field says which; each period lists its KPI values and derived_kpis (Q4 values MARS computed as FY minus Q1-Q3). Latest 20 reporting periods by default, newest first. A company with no KPI rows returns status='not_covered'; an unresolvable input returns status='unresolved'.
Input: ticker_or_cik. Heavy verticals (biotech, mining) have their own dedicated tools.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"ticker_or_cik": "<ticker_or_cik>"
},
"name": "operating_metrics"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| max_periods | No | Latest N reporting periods (default 20, max 60). | |
| ticker_or_cik | Yes | Company ticker (Atlas-resolved) or SEC CIK. Required. |