GET /v1/forecast/pointdynamic ($0.01 for hours ≤ 48, $0.03 beyond)realtimetier: datacache 900sEngine B — Weather Intelligence
Hourly temperature, feels-like, precipitation probability/amount, wind, gusts, humidity, and cloud cover for an exact lat/lon: NWS-derived series, bias-blended with our calibrated station model where covered. Imperial by default (units=metric available). Requests beyond 168 hours are capped at the model's current horizon. Longer horizons cost more.
Pricing: $0.01 for hours ≤ 48, $0.03 beyond
| Name | In | Type | Required | Notes |
|---|---|---|---|---|
lat | query | number | yes | |
lon | query | number | yes | |
hours | query | integer | no | (default: 48) |
units | query | string | no | (default: "imperial") — one of "metric", "imperial" |
curl "https://x402-factory.com/v1/forecast/point?lat=40.7829&lon=-73.9654&hours=24"
Central Park, next 24h — $0.01.
{
"data": {
"hourly": [
{
"t": "2026-07-18T12:00:00.000Z",
"temp": 78.3,
"feels_like": 78.3,
"precip_prob": 0.58,
"precip_amount": 0.06,
"wind": 13.5,
"gust": 21.7,
"humidity_pct": 58,
"cloud_pct": 62
},
{
"t": "2026-07-18T13:00:00.000Z",
"temp": 76.5,
"feels_like": 76.5,
"precip_prob": 0.56,
"precip_amount": 0.06,
"wind": 13.5,
"gust": 20.8,
"humidity_pct": 59,
"cloud_pct": 62
},
{
"t": "2026-07-18T14:00:00.000Z",
"temp": 75.7,
"feels_like": 75.7,
"precip_prob": 0.55,
"precip_amount": 0.06,
"wind": 13.7,
"gust": 21.4,
"humidity_pct": 47,
"cloud_pct": 60
},
{
"t": "2026-07-18T15:00:00.000Z",
"temp": 73,
"feels_like": 73,
"precip_prob": 0.55,
"precip_amount": 0.06,
"wind": 14,
"gust": 21.4,
"humidity_pct": 44,
"cloud_pct": 66
},
{
"t": "2026-07-18T16:00:00.000Z",
"temp": 70,
"feels_like": 70,
"precip_prob": 0.55,
"precip_amount": 0.06,
"wind": 14.4,
"gust": 23.1,
"humidity_pct": 58,
"cloud_pct": 51
},
{
"t": "2026-07-18T17:00:00.000Z",
"temp": 69.8,
"feels_like": 69.8,
"precip_prob": 0.06,
"precip_amount": 0,
"wind": 8.6,
"gust": 14.2,
"humidity_pct": 58,
"cloud_pct": 6
},
{
"t": "2026-07-18T18:00:00.000Z",
"temp": 68.7,
"feels_like": 68.7,
"precip_prob": 0.06,
"precip_amount": 0,
"wind": 9,
"gust": 15.3,
"humidity_pct": 60,
"cloud_pct": 16
},
{
"t": "2026-07-18T19:00:00.000Z",
"temp": 66.7,
"feels_like": 66.7,
"precip_prob": 0.06,
"precip_amount": 0,
"wind": 9.5,
"gust": 15.9,
"humidity_pct": 43,
"cloud_pct": 28
},
{
"t": "2026-07-18T20:00:00.000Z",
"temp": 66.9,
"feels_like": 66.9,
"precip_prob": 0.06,
"precip_amount": 0,
"wind": 9.9,
"gust": 17.5,
"humidity_pct": 54,
"cloud_pct": 33
},
{
"t": "2026-07-18T21:00:00.000Z",
"temp": 67.8,
"feels_like": 67.8,
"precip_prob": 0.07,
"precip_amount": 0,
"wind": 10.4,
"gust": 17.8,
"humidity_pct": 57,
"cloud_pct": 16
},
{
"t": "2026-07-18T22:00:00.000Z",
"temp": 66.9,
"feels_like": 66.9,
"precip_prob": 0.07,
"precip_amount": 0,
"wind": 10.6,
"gust": 16.5,
"humidity_pct": 55,
"cloud_pct": 33
},
{
"t": "2026-07-18T23:00:00.000Z",
"temp": 68.2,
"feels_like": 68.2,
"precip_prob": 0.13,
"precip_amount": 0,
"wind": 16.2,
"gust": 25.5,
"humidity_pct": 46,
"cloud_pct": 12
},
{
"t": "2026-07-19T00:00:00.000Z",
"temp": 69.4,
"feels_like": 69.4,
"precip_prob": 0.08,
"precip_amount": 0,
"wind": 15.7,
"gust": 25.2,
"humidity_pct": 43,
"cloud_pct": 16
},
{
"t": "2026-07-19T01:00:00.000Z",
"temp": 71.6,
"feels_like": 71.6,
"precip_prob": 0.09,
"precip_amount": 0,
"wind": 15.7,
"gust": 24.7,
"humidity_pct": 59,
"cloud_pct": 24
},
{
"t": "2026-07-19T02:00:00.000Z",
"temp": 72.9,
"feels_like": 72.9,
"precip_prob": 0.09,
"precip_amount": 0,
"wind": 15.5,
"gust": 23.1,
"humidity_pct": 55,
"cloud_pct": 30
},
{
"t": "2026-07-19T03:00:00.000Z",
"temp": 76.5,
"feels_like": 76.5,
"precip_prob": 0.09,
"precip_amount": 0,
"wind": 15.2,
"gust": 23.7,
"humidity_pct": 46,
"cloud_pct": 28
},
{
"t": "2026-07-19T04:00:00.000Z",
"temp": 76.5,
"feels_like": 76.5,
"precip_prob": 0.09,
"precip_amount": 0,
"wind": 14.8,
"gust": 24.2,
"humidity_pct": 49,
"cloud_pct": 10
},
{
"t": "2026-07-19T05:00:00.000Z",
"temp": 78.1,
"feels_like": 78.1,
"precip_prob": 0.14,
"precip_amount": 0,
"wind": 15.3,
"gust": 23,
"humidity_pct": 56,
"cloud_pct": 27
},
{
"t": "2026-07-19T06:00:00.000Z",
"temp": 81.5,
"feels_like": 81.5,
"precip_prob": 0.14,
"precip_amount": 0,
"wind": 14.8,
"gust": 22.7,
"humidity_pct": 46,
"cloud_pct": 27
},
{
"t": "2026-07-19T07:00:00.000Z",
"temp": 79.9,
"feels_like": 79.9,
"precip_prob": 0.13,
"precip_amount": 0,
"wind": 14.3,
"gust": 21.3,
"humidity_pct": 47,
"cloud_pct": 36
},
{
"t": "2026-07-19T08:00:00.000Z",
"temp": 80.8,
"feels_like": 80.8,
"precip_prob": 0.13,
"precip_amount": 0,
"wind": 13.9,
"gust": 20.9,
"humidity_pct": 56,
"cloud_pct": 15
},
{
"t": "2026-07-19T09:00:00.000Z",
"temp": 81.3,
"feels_like": 81.3,
"precip_prob": 0.12,
"precip_amount": 0,
"wind": 13.5,
"gust": 21.3,
"humidity_pct": 51,
"cloud_pct": 28
},
{
"t": "2026-07-19T10:00:00.000Z",
"temp": 80.6,
"feels_like": 80.6,
"precip_prob": 0.12,
"precip_amount": 0,
"wind": 13.2,
"gust": 21.6,
"humidity_pct": 52,
"cloud_pct": 35
},
{
"t": "2026-07-19T11:00:00.000Z",
"temp": 77.5,
"feels_like": 77.5,
"precip_prob": 0.06,
"precip_amount": 0,
"wind": 9.4,
"gust": 15.4,
"humidity_pct": 49,
"cloud_pct": 23
}
],
"model_run_at": "2026-07-18T12:00:00.000Z",
"units": "imperial"
},
"meta": {
"endpoint": "/v1/forecast/point",
"version": "1.0.0",
"generated_at": "2026-08-18T22:54:16.975Z",
"freshness": "realtime",
"sources": [
"stub-model"
],
"request_id": "req_00000000",
"docs": "https://x402-factory.com/docs/weather.forecast-point",
"data_mode": "live"
}
}data payload){
"type": "object",
"properties": {
"hourly": {
"type": "array",
"items": {
"type": "object",
"properties": {
"t": {
"type": "string"
},
"temp": {
"type": "number"
},
"feels_like": {
"type": "number"
},
"precip_prob": {
"type": "number",
"minimum": 0,
"maximum": 1
},
"precip_amount": {
"type": "number"
},
"wind": {
"type": "number"
},
"gust": {
"type": "number"
},
"humidity_pct": {
"type": "number"
},
"cloud_pct": {
"type": "number"
}
},
"required": [
"t",
"temp",
"feels_like",
"precip_prob",
"precip_amount",
"wind",
"gust",
"humidity_pct",
"cloud_pct"
],
"additionalProperties": false
}
},
"model_run_at": {
"type": "string"
},
"units": {
"type": "string",
"enum": [
"metric",
"imperial"
]
}
},
"required": [
"hourly",
"model_run_at",
"units"
],
"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 dynamic ($0.01 for hours ≤ 48, $0.03 beyond) 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. |