{ "name": "GridPulse", "description": "US energy intelligence API — 12 endpoints covering retail electricity prices, power grid status (ERCOT/CAISO/PJM/MISO/ISONE/NYISO/SPP), renewable energy mix, natural gas markets, 90-day energy forecasts, EV charging cost vs. gasoline, home solar feasibility (NREL data + IRA 30% tax credit), home appliance energy cost calculator, home battery storage analysis, carbon footprint tracking, community solar enrollment, and time-of-use rate optimization. Returns structured JSON. Requires x402 micropayment (USDC on Base mainnet).", "version": "1.2.0", "url": "https://gridpulse.vercel.app", "payment": { "protocol": "x402", "network": "eip155:8453", "asset": "USDC", "contract": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x50ab2018c06c6E4eAA9BA52057Eb55eD284912fc", "price_range_usd": "0.05–0.10" }, "global_coverage": { "primary": "United States — all 50 states, all major ISOs (ERCOT, CAISO, PJM, MISO, ISONE, NYISO, SPP)", "data_sources": "EIA (US Energy Information Administration), NREL (National Renewable Energy Laboratory), FRED (Federal Reserve), Henry Hub spot pricing, ISO grid APIs", "note": "Primarily US-focused energy market data; global energy context available via the natural-gas endpoint (LNG export/import markets) and carbon endpoint (global carbon credit markets)" }, "capabilities": [ "Retail electricity prices by state — residential, commercial, industrial rates vs national average", "Power grid status — real-time demand, capacity utilization, generation mix for all 7 major US ISOs", "Renewable energy mix — generation percentages, carbon intensity, clean energy trend by state", "Natural gas markets — Henry Hub spot price, storage vs 5-year average, electricity/heating cost impact", "90-day energy forecasts — price direction, peak risk, grid reliability outlook by state", "EV charging cost vs. gasoline — cost per mile, annual savings, off-peak charging strategy", "Home solar feasibility — NREL production estimate, IRA 30% tax credit, payback period, 25-year savings", "Home appliance energy cost — annual cost per appliance, upgrade ROI, Energy Star recommendations", "Home battery storage — Powerwall/Enphase sizing, cost, TOU arbitrage savings, outage backup hours", "Carbon footprint — household carbon score by state grid mix, offset marketplace, reduction roadmap", "Community solar — enrollment availability by ZIP, bill credit rates, waitlist status, savings estimate", "Time-of-use rate optimization — peak/off-peak windows, appliance scheduling, annual savings vs flat rate" ], "data_sources": [ "EIA Open Data (free): retail electricity rates, generation mix, natural gas storage", "NREL PVWatts (free): solar production estimates by location", "FRED (free): Henry Hub natural gas spot price, energy CPI", "ISO grid APIs (free): real-time grid demand and generation mix", "Tavily real-time synthesis: rate changes, utility news, IRA incentive updates" ], "endpoints": [ { "path": "/api/energy/prices", "method": "GET", "description": "Retail electricity rates for a US state — residential, commercial, and industrial rates, trend vs national average, monthly bill estimate for typical household, price drivers (fuel mix, transmission, policy), and 90-day price outlook. Data from EIA.", "required_params": ["state"], "optional_params": ["usage_kwh"], "price_usd": 0.08, "agent_use_case": "on-demand", "agent_chaining": "Start here for any energy cost workflow; follow with /api/energy/forecast for forward-looking analysis; pair with /api/energy/tou for rate optimization" }, { "path": "/api/energy/grid", "method": "GET", "description": "Real-time power grid status for a major US ISO (ERCOT, CAISO, PJM, MISO, ISONE, NYISO, SPP) — current demand vs capacity, capacity utilization percentage, generation mix by fuel type (natural gas, coal, nuclear, wind, solar), grid stress level, and any active reliability alerts.", "required_params": ["region"], "optional_params": [], "price_usd": 0.08, "agent_use_case": "on-demand", "agent_chaining": "Follow with /api/energy/forecast for grid reliability outlook; pair with /api/energy/renewable for carbon intensity context" }, { "path": "/api/energy/renewable", "method": "GET", "description": "Renewable energy profile for a US state — generation mix percentages (wind, solar, hydro, nuclear vs fossil), carbon intensity rating (gCO2e/kWh), national ranking among 50 states, clean energy trend over 5 years, and optimal EV charging window for lowest carbon impact.", "required_params": ["state"], "optional_params": [], "price_usd": 0.08, "agent_use_case": "on-demand", "agent_chaining": "Follow with /api/energy/carbon for household carbon footprint analysis; pair with /api/energy/ev-cost for EV environmental impact" }, { "path": "/api/energy/natural-gas", "method": "GET", "description": "Henry Hub natural gas market briefing — current spot price, week-over-week and year-over-year change, storage vs 5-year seasonal average (surplus/deficit), supply/demand balance, electricity generation cost impact, home heating cost impact, and 90-day price outlook.", "required_params": [], "optional_params": ["region"], "price_usd": 0.08, "agent_use_case": "on-demand", "agent_chaining": "Pairs with /api/energy/forecast — natural gas is the primary driver of electricity price forecasts in most US markets" }, { "path": "/api/energy/forecast", "method": "GET", "description": "90-day energy forecast for a US state — electricity price direction and expected range, demand outlook (seasonal factors, weather normalization), peak risk periods (days most likely to have grid stress), natural gas price linkage, grid reliability outlook, and recommended consumer and business actions.", "required_params": ["state"], "optional_params": [], "price_usd": 0.10, "agent_use_case": "on-demand", "agent_chaining": "Use before any energy contract renewal or major appliance purchase decision; follow with /api/energy/tou for rate optimization given the forecast" }, { "path": "/api/energy/ev-cost", "method": "GET", "description": "EV charging cost vs gasoline comparison for a US state — cost per mile (electricity vs gas), annual charging cost at current rates, annual gas cost equivalent, annual savings from switching to EV, off-peak charging strategy (time windows and savings), and home Level 2 charger recommendation.", "required_params": ["state"], "optional_params": ["miles", "mpg", "ev_model"], "price_usd": 0.08, "agent_use_case": "on-demand", "agent_chaining": "Follow with /api/energy/renewable to add carbon impact dimension to EV cost analysis; pair with /api/energy/tou to optimize charging schedule" }, { "path": "/api/energy/solar", "method": "GET", "description": "Home solar feasibility analysis — NREL PVWatts production estimate (kWh/year), system cost before and after IRA 30% federal tax credit, payback period (years), 25-year net savings, net metering policy and bill credit rate, local incentives stacked with federal credit, and EnergySage comparison quote link.", "required_params": [], "optional_params": ["zip", "state", "system_kw", "monthly_bill"], "price_usd": 0.10, "agent_use_case": "on-demand", "agent_chaining": "Follow with /api/energy/battery to analyze adding home battery storage to a solar system; pair with /api/energy/prices for electricity cost payback validation" }, { "path": "/api/energy/appliance", "method": "GET", "description": "Home appliance energy cost calculator — annual electricity cost for any major appliance, cost vs national average, upgrade ROI if switching to Energy Star equivalent (payback period, 10-year savings), and the most cost-effective upgrade sequence for a typical household. Covers HVAC, water heater, refrigerator, washer/dryer, dishwasher, lighting.", "required_params": ["appliance"], "optional_params": ["state", "usage_hours", "age_years"], "price_usd": 0.05, "agent_use_case": "on-demand", "agent_chaining": "Follow with /api/energy/prices for state-specific electricity rate context; pairs well with /api/energy/forecast if a major appliance purchase decision depends on future electricity prices" }, { "path": "/api/energy/battery", "method": "GET", "description": "Home battery storage analysis — system sizing recommendation (Tesla Powerwall, Enphase IQ, Generac PWRcell), total installed cost before IRA 30% tax credit, TOU arbitrage savings (buy off-peak, sell/offset on-peak), payback period, outage backup duration for critical loads, and whether solar + battery or battery-only makes sense for the situation.", "required_params": [], "optional_params": ["state", "monthly_bill", "has_solar", "outage_priority"], "price_usd": 0.10, "agent_use_case": "on-demand", "agent_chaining": "Pairs with /api/energy/solar — battery adds backup and TOU optimization on top of solar ROI; follow with /api/energy/tou to quantify TOU arbitrage value" }, { "path": "/api/energy/carbon", "method": "GET", "description": "Household carbon footprint from electricity use — annual tCO2e from electricity consumption, comparison vs state and national average, carbon offset cost (verified marketplace options — Gold Standard, Verra VCS), and a prioritized carbon reduction roadmap (appliance upgrades, solar, EV, behavioral changes) with cost and impact per action.", "required_params": [], "optional_params": ["state", "monthly_kwh", "household_size"], "price_usd": 0.05, "agent_use_case": "on-demand", "agent_chaining": "Follow with /api/energy/renewable for state grid carbon intensity context; follow with /api/energy/solar or /api/energy/appliance for high-impact reduction actions" }, { "path": "/api/energy/community-solar", "method": "GET", "description": "Community solar enrollment analysis by ZIP code — project availability (utility-specific programs, independent aggregators like Arcadia or EnergySage), bill credit rate (typically 10–15% of allocated kWh), estimated annual savings, current waitlist status, and step-by-step enrollment guide. Best option for renters or households where rooftop solar is not feasible.", "required_params": ["zip"], "optional_params": ["monthly_bill", "credit_preference"], "price_usd": 0.08, "agent_use_case": "on-demand", "agent_chaining": "Use when /api/energy/solar analysis shows rooftop solar is infeasible (renter, shading, HOA restriction); follow with /api/energy/prices for baseline electricity cost context" }, { "path": "/api/energy/tou", "method": "GET", "description": "Time-of-use rate optimization guide for a US state — TOU rate availability from the utility, peak and off-peak windows (by season), estimated annual savings vs flat rate, optimal appliance scheduling (dishwasher, laundry, EV charging, pool pump), and whether switching to a TOU plan makes financial sense based on household load profile.", "required_params": ["state"], "optional_params": ["utility", "has_ev", "has_solar", "monthly_bill"], "price_usd": 0.08, "agent_use_case": "on-demand", "agent_chaining": "Follow with /api/energy/ev-cost to quantify TOU savings specifically for EV charging; pairs with /api/energy/battery for TOU arbitrage analysis" } ], "example_queries": [ "GET /api/energy/prices?state=TX", "GET /api/energy/grid?region=ercot", "GET /api/energy/renewable?state=CA", "GET /api/energy/natural-gas", "GET /api/energy/forecast?state=NY", "GET /api/energy/ev-cost?state=FL&miles=15000", "GET /api/energy/solar?zip=78701&system_kw=8", "GET /api/energy/appliance?appliance=hvac&state=TX&age_years=12", "GET /api/energy/battery?state=CA&has_solar=true&monthly_bill=180", "GET /api/energy/carbon?state=WV&monthly_kwh=1200&household_size=4", "GET /api/energy/community-solar?zip=60601&monthly_bill=120", "GET /api/energy/tou?state=CA&has_ev=true&utility=PGE" ], "network": "PulseNetwork", "sibling_apis": [ { "name": "PropPulse", "url": "https://proppulse-gules.vercel.app", "relevance": "Home buyers and homeowners — solar feasibility + battery storage analysis pairs with PropPulse property valuation" }, { "name": "WealthPulse", "url": "https://wealthpulse-phi.vercel.app", "relevance": "IRA tax credit optimization for solar/battery investments — pairs with WealthPulse tax planning" }, { "name": "AutoPulse", "url": "https://autopulse-orpin.vercel.app", "relevance": "EV purchasing decisions — GridPulse EV cost analysis pairs with AutoPulse vehicle comparison" }, { "name": "OnchainPulse", "url": "https://onchainpulse.vercel.app", "relevance": "Carbon credit tokenization and on-chain carbon offset markets" } ], "openapi": "https://gridpulse.vercel.app/openapi.json", "llms_txt": "https://gridpulse.vercel.app/llms.txt", "disclaimer": "For informational purposes only. Energy rates, grid data, and solar estimates are approximations. Consult your utility and a licensed installer for binding quotes." }