Power Capacity Events (per-unit add/retire pipeline) [beta]
sec_power_capacity_eventsPer-unit capacity add/retire pipeline from SEC disclosures. The row-level view that backs sec_power_supply_curve aggregation — useful when the question is about specific units ('what's NextEra's gas-build pipeline', 'every coal retirement announced in 2024') rather than aggregate trends.
Filter by filer (ticker_or_cik), event_type ('addition' / 'retirement'), fuel (coal / gas / gas_ccgt / gas_peaker / wind / solar / battery / nuclear / hydro / biomass / oil), status ('announced' / 'permitted' / 'under_construction' / 'completed' / 'cancelled'), ISO/RTO market, or target-year range.
Returns: filer_cik, unit_name_raw, event_type, fuel_type, mw, target_dt (COD), status, location_state, primary_iso, disclosed_capex_dollars, plus the source_accession + filed_at + snippet for citation. Deduped to the latest filing per (filer, unit, event_type).
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "sec_power_capacity_events"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| iso | No | ISO/RTO market scope (PJM / ERCOT / CAISO / MISO / NYISO / ISO-NE / SPP / non-RTO). | |
| fuel | No | Fuel type filter (coal / gas / gas_ccgt / gas_peaker / wind / solar / battery / nuclear / hydro / biomass / oil). | |
| as_of | No | Point-in-time as-of date — applies DISTINCT ON dedup with filed_at <= as_of BEFORE the dedup. | |
| limit | No | Max events (default 100, max 500). | |
| status | No | Status filter (announced / permitted / under_construction / completed / cancelled). | |
| year_to | No | Upper bound on target_year (default 2040). | |
| year_from | No | Lower bound on target_year (default 2024). | |
| event_type | No | addition or retirement. | |
| ticker_or_cik | No | Filter to one filer (ticker / CIK / name substring). Use sec_power_gazetteer to resolve. |