electricity_ev_charging_cost
Monthly and yearly cost of charging an electric vehicle at home on the cheapest fixed-rate plans in a Texas utility: each plan's estimated cost with and without the EV, cost per mile. Give ev_miles plus a vehicle (EPA efficiency from fueleconomy.gov) or ev_kwh_per_mile. The response also has a time_of_use section: free-nights and free-weekends plans priced on overnight charging (ev_night_share, default 0.80; home_night_share), each with its exact free hours as written in its Electricity Facts Label, or the reason it was excluded. No gasoline comparison (we do not collect gasoline prices). Free for non-commercial use with attribution; commercial use requires Pro.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kwh | No | Average monthly usage in kWh (default 1000). Spread over a typical Texas year (summer-heavy). | |
| months | No | Optional: 12 monthly kWh values, January first. Overrides kwh. | |
| utility | Yes | Utility (TDU) id. Dallas–Fort Worth: oncor · Houston: centerpoint · Corpus Christi / Rio Grande Valley: aep_central · Abilene / San Angelo: aep_north · Texas City / Lewisville: tnmp · Lubbock: lpl | |
| vehicle | No | EV model (2025, EPA efficiency from fueleconomy.gov); or give ev_kwh_per_mile | |
| ev_miles | Yes | Optional EV: miles driven per month; adds home-charging kWh to every month (fixed-rate plans). | |
| ev_night_share | No | Time-of-use section: share of EV kWh charged overnight (10 pm - 6 am), 0-1 (a value above 1 is read as a percent). Default 0.80 | |
| ev_kwh_per_mile | No | Optional instead of vehicle (default 0.30) | |
| home_night_share | No | Time-of-use section: share of the home's kWh in a free-nights plan's free hours. Default: the share the plan's own label assumes (35%) | |
| charging_efficiency | No | Default 0.90 with ev_kwh_per_mile; 1.0 with vehicle (EPA figures include charging losses) |