irrigation derived

{
  "input": {
    "type": "http",
    "method": "GET",
    "queryParams": {
      "lat": "36.72 (required)",
      "lon": "-119.79 (required)",
      "crop": "almonds",
      "lang": "en"
    }
  },
  "output": {
    "type": "json",
    "errors": {
      "400": {
        "example": {
          "error": "invalid request"
        },
        "description": "Invalid or missing parameter(s). 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": {
      "crop": "almonds",
      "water_budget": {
        "et0_method": "FAO-56 Penman-Monteith computed from MET Norway forecast",
        "et0_mm_day": 8.2,
        "etc_mm_day": 8.6,
        "crop_coefficient_kc": 1.05,
        "recent_precip_mm_7day": 0,
        "recommended_application_mm": "45mm"
      },
      "next_rain_event": "None forecast in next 7 days",
      "water_stress_risk": "moderate",
      "irrigation_decision": "irrigate_within_48h",
      "irrigation_schedule": {
        "frequency": "Every 5-6 days",
        "duration_hours": "6-8h (drip system at 6mm/hr)",
        "next_irrigation_date": "tomorrow"
      },
      "soil_wetness_context": {
        "note": "Observed, lagged. Fraction of saturation — NOT volumetric water content, and NOT convertible to a mm deficit.",
        "as_of": "2026-07-09",
        "lag_days": 4,
        "surface_frac_0_1": 0.21
      }
    }
  }
}