GET /v1/forecast/houston/window

$0.02realtimetier: datacache 900sEngine B — Weather Intelligence

Event-window weather odds for Houston: pass a start and end time (or omit them for the next six hours) and get rain probability and expected conditions across the window — built for scheduling decisions. Same shape as /v1/forecast/window with the Houston coordinates built in.

Parameters

NameInTypeRequiredNotes
startquerystringnoWindow start (ISO-8601). Default: the top of the next hour.
endquerystringnoWindow end (ISO-8601), ≤12h after start. Default: start + 6h.

Example

curl "https://x402-factory.com/v1/forecast/houston/window"

Central Park over the default window (the next six hours).

Example response

{
  "data": {
    "rain_probability": 0.17,
    "expected_precip_mm": 0,
    "temp_range": {
      "low": 25,
      "high": 31.5
    },
    "wind_max": 31.8,
    "comfort_index": 0.59,
    "severity_flags": [],
    "verdict": "Looks good: warm, highs near 88.7°F, low rain risk."
  },
  "meta": {
    "endpoint": "/v1/forecast/houston/window",
    "version": "1.0.0",
    "generated_at": "2026-09-13T09:52:16.476Z",
    "freshness": "realtime",
    "sources": [
      "stub-model"
    ],
    "request_id": "req_00000000",
    "docs": "https://x402-factory.com/docs/weather.forecast-window.houston",
    "data_mode": "live"
  }
}

Response schema (data payload)

{
  "type": "object",
  "properties": {
    "rain_probability": {
      "type": "number",
      "minimum": 0,
      "maximum": 1
    },
    "expected_precip_mm": {
      "type": "number"
    },
    "temp_range": {
      "type": "object",
      "properties": {
        "low": {
          "type": "number"
        },
        "high": {
          "type": "number"
        }
      },
      "required": [
        "low",
        "high"
      ],
      "additionalProperties": false
    },
    "wind_max": {
      "type": "number"
    },
    "comfort_index": {
      "type": "number",
      "minimum": 0,
      "maximum": 1
    },
    "severity_flags": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "verdict": {
      "type": "string"
    }
  },
  "required": [
    "rain_probability",
    "expected_precip_mm",
    "temp_range",
    "wind_max",
    "comfort_index",
    "severity_flags",
    "verdict"
  ],
  "additionalProperties": false
}

The platform wraps every payload in an envelope: { "data": …, "meta": { endpoint, version, generated_at, freshness, sources, request_id, docs, data_mode } }.

Payment (x402)

Unpaid requests receive 402 with payment requirements (accepts). Pay $0.02 in USDC on Base per call via an X-PAYMENT header — see docs.x402.org. With PAYMENT_MODE=disabled (local dev) the endpoint is open.

Errors

StatusCodeMeaning
400INVALID_PARAMSInput failed validation; message lists the offending fields.
404NOT_FOUNDNo matching resource; suggestion may point to a sibling endpoint.
410RESOLVEDMarket/event settled; body includes a resolution summary.
503STALE_DATAUpstream feed down; stale data is never silently served beyond 2× cache TTL.
500INTERNALOur bug. The request_id helps us find it.