gridpulse

Parameters schema

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "action"
  ],
  "properties": {
    "mw": {
      "type": "string",
      "description": "Load in MW — scales the absolute CO2 and EUR savings"
    },
    "zip": {
      "type": "string",
      "description": "US ZIP code (preferred)"
    },
    "goal": {
      "type": "string",
      "description": "What to optimise. cost and blend require a region with a published day-ahead price series (DE, FR, BE and other bidding zones)."
    },
    "lang": {
      "type": "string",
      "description": "Response language (default en)"
    },
    "hours": {
      "type": "string",
      "description": "Forward window in hours, 1-48"
    },
    "miles": {
      "type": "string",
      "description": "Annual miles (1,000-100,000)"
    },
    "state": {
      "type": "string",
      "description": "2-letter US state code (TX, CA, NY, etc.; default: US)"
    },
    "action": {
      "enum": [
        "carbon-intensity",
        "compute-window",
        "prices",
        "grid",
        "renewable",
        "natural-gas",
        "forecast",
        "ev-cost",
        "solar",
        "appliance",
        "battery",
        "carbon",
        "community-solar",
        "tou"
      ],
      "type": "string",
      "description": "Which endpoint to call. Options: carbon-intensity | compute-window | prices | grid | renewable | natural-gas | forecast | ev-cost | solar | appliance | battery | carbon | community-solar | tou"
    },
    "has_ev": {
      "type": "string",
      "description": "true if household has an EV (major TOU savings driver)"
    },
    "region": {
      "type": "string",
      "description": "UK | a GB DNO region (london, north-scotland, …) | DE FR NL BE AT ES IT NO"
    },
    "utility": {
      "type": "string",
      "description": "Utility name (e.g., PGE, SCE, ConEd) for utility-specific TOU plans"
    },
    "location": {
      "type": "string",
      "description": "City, State or place name"
    },
    "max_gco2": {
      "type": "string",
      "description": "Optional carbon budget in gCO2/kWh. Returns the earliest window meeting it, or satisfiable:false."
    },
    "age_years": {
      "type": "string",
      "description": "Appliance age in years (affects upgrade ROI calculation)"
    },
    "appliance": {
      "type": "string",
      "description": "Appliance type (hvac, water-heater, refrigerator, washer, dryer, dishwasher, lighting)"
    },
    "has_solar": {
      "type": "string",
      "description": "Whether the property already has solar"
    },
    "system_kw": {
      "type": "string",
      "description": "System size in kW (2-20)"
    },
    "monthly_kwh": {
      "type": "string",
      "description": "Average monthly consumption in kWh"
    },
    "usage_hours": {
      "type": "string",
      "description": "Daily usage hours (default varies by appliance)"
    },
    "monthly_bill": {
      "type": "string",
      "description": "Average monthly electricity bill in USD"
    },
    "household_size": {
      "type": "string",
      "description": "Number of people in household"
    },
    "credit_preference": {
      "type": "string",
      "description": "Preference for bill credit vs. direct payment programs"
    }
  },
  "additionalProperties": false
}

• Data resourceOpen-Meteo API

  Open-Meteo · weather

  name mention0.70

Parent server