GET /v1/forecast/nashville/window$0.02realtimetier: datacache 900sEngine B — Weather Intelligence
Event-window weather odds for Nashville: 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 Nashville coordinates built in.
| Name | In | Type | Required | Notes |
|---|---|---|---|---|
start | query | string | no | Window start (ISO-8601). Default: the top of the next hour. |
end | query | string | no | Window end (ISO-8601), ≤12h after start. Default: start + 6h. |
curl "https://x402-factory.com/v1/forecast/nashville/window"
Central Park over the default window (the next six hours).
{
"data": {
"rain_probability": 0.1,
"expected_precip_mm": 0,
"temp_range": {
"low": 25.3,
"high": 30.6
},
"wind_max": 24.7,
"comfort_index": 0.69,
"severity_flags": [],
"verdict": "Looks good: warm, highs near 87.1°F, low rain risk."
},
"meta": {
"endpoint": "/v1/forecast/nashville/window",
"version": "1.0.0",
"generated_at": "2026-09-13T09:52:16.477Z",
"freshness": "realtime",
"sources": [
"stub-model"
],
"request_id": "req_00000000",
"docs": "https://x402-factory.com/docs/weather.forecast-window.nashville",
"data_mode": "live"
}
}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 } }.
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.
| Status | Code | Meaning |
|---|---|---|
| 400 | INVALID_PARAMS | Input failed validation; message lists the offending fields. |
| 404 | NOT_FOUND | No matching resource; suggestion may point to a sibling endpoint. |
| 410 | RESOLVED | Market/event settled; body includes a resolution summary. |
| 503 | STALE_DATA | Upstream feed down; stale data is never silently served beyond 2× cache TTL. |
| 500 | INTERNAL | Our bug. The request_id helps us find it. |