climate event derived

{
  "input": {
    "type": "http",
    "method": "GET",
    "queryParams": {
      "date": "2026-09-15",
      "lang": "es",
      "location": "Napa, CA",
      "event_type": "wedding"
    }
  },
  "output": {
    "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"
      ]
    }
  }
}