ClimatePulse Event Climate Intelligence

{
  "type": "json",
  "errors": {
    "400": {
      "example": {
        "error": "location parameter required"
      },
      "description": "Invalid or missing parameter(s) — required: location, date. Returned before the payment gate on paid requests, so a malformed call is never charged. JSON body: { error: <what is wrong and how to fix it> } plus usage hints."
    },
    "402": {
      "description": "Payment required — x402 v2 challenge; the accepts array lists scheme, network, and amount. Retry the same request with a PAYMENT-SIGNATURE (v2) or X-PAYMENT (v1) header. Verification is free."
    },
    "500": {
      "example": {
        "error": "upstream_failed"
      },
      "description": "Unexpected server error. If a payment settled without a usable result, contact info@theaslangroupllc.com with the settlement tx hash for a re-run or credit."
    }
  },
  "example": {
    "location": "Napa, CA",
    "affiliates": {
      "weather_gear": "https://www.rei.com/search?q=weather+gear"
    },
    "disclaimer": "Historical climate data indicates statistical likelihood only. Actual conditions on a specific date cannot be predicted beyond ~10 days. Always check a forecast as your event approaches.",
    "target_date": "2026-09-15",
    "generated_at": "2026-07-03T12:00:00.000Z",
    "target_month": "September",
    "best_case_scenario": "Clear skies, mid-80s, light breeze",
    "historical_caveats": "Based on regional historical averages, not this specific site",
    "typical_conditions": "Warm, dry, and sunny with cool evenings — peak Napa Valley harvest season",
    "weather_risk_level": "low",
    "historical_averages": {
      "average_low_f": 52,
      "average_high_f": 84,
      "average_sunny_days_pct": 90,
      "average_rain_days_in_month": 1,
      "average_precipitation_inches": 0.2
    },
    "optimal_time_of_day": "Late afternoon into evening",
    "worst_case_scenario": "A rare early-season heat spike into the mid-90s",
    "event_planning_guidance": "Low rain risk; the main consideration is afternoon heat — schedule the ceremony for early evening",
    "probability_assessments": {
      "hurricane_season": false,
      "rain_probability_pct": 8,
      "frost_probability_pct": 0,
      "severe_weather_season": false,
      "extreme_heat_probability_pct": 15,
      "significant_rain_probability_pct": 2
    },
    "contingency_recommendations": [
      "Have shade or a tent as a heat contingency",
      "Rain contingency is low priority this month"
    ]
  }
}