WaterPulse Streamflow API

{
  "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": {
    "signal": "Widespread below-normal flows across Colorado indicate ongoing drought stress. No flood risk at monitored sites.",
    "data_source": "USGS Instantaneous Values Water Services",
    "flow_summary": {
      "sites_in_flood": 0,
      "lowest_flow_site": "Arkansas River nr Pueblo — 34% of median",
      "sites_above_normal": 1,
      "sites_below_normal": 8
    },
    "query_summary": {
      "state": "CO",
      "parameter": "discharge_cfs",
      "sites_analyzed": 10
    },
    "stream_readings": [
      {
        "date_time": "2026-06-07T14:00:00",
        "site_code": "09380000",
        "site_name": "Colorado River at Lees Ferry, AZ",
        "discharge_cfs": "8420",
        "flow_condition": "Below normal",
        "percent_of_median": 61
      }
    ]
  }
}