Power Fundamentals (per-ticker capacity/demand/outage panel + rate cases + coverage) [beta]
sec_power_fundamentalsPer-ticker power-sector fundamentals — a utility/IPP's year-by-year operating panel in one call: panel[] (capacity added/retired MW + net-by-fuel, firm data-center/large-load demand + YoY, outage count/MW, per year), identity (role / ISO / regulated-vs-merchant / is_active), rate_cases[] (commission rulings: allowed_roe, revenue increase, outcome), and coverage (a bool per dataset). Powers inferno's SIC-routed power section.
coverage is load-bearing, not decorative — a ticker can have real capacity + rate-case data but ZERO demand/outage extraction (AEP has no firm data-center commitments in the corpus). A naive zero would read as 'no data-center commitments' (false) vs 'none extracted' (the real state). Check coverage.demand before reading a 0 as a finding.
panel = last 10 years WITH DATA (not last 10 calendar years) — for a sparsely-covered ticker this can span decades (AEP's top-10 spans 1991-2025). Blank recent years are omitted rather than zero-filled.
Rate-case honesty: we surface allowed_roe (the OUTCOME ROE), revenue_increase_dollars, decided_date, status — NOT requested_roe, rate_base_usd, or the commission filed_date (not extracted; a v2 ask, not a silent null-map). allowed_roe hasn't had a two-model QA pass — rows outside a plausible utility band [3%, 20%] carry allowed_roe_suspect=true (rare mis-extraction, e.g. a rate adjustment read as the ROE).
Methodology: filer-disclosed SEC extractions only (not the full universe), per the sec_power_* family. Input: ticker_or_cik.
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": "sec_power_fundamentals"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ticker_or_cik | Yes | Utility/IPP ticker (e.g. 'AEP', 'DTE') or CIK. Required. |