GET /v1/aviation/delay-risk/SFO

$0.02realtimetier: datacache 1800sEngine B — Weather Intelligence

Weather-driven delay risk for San Francisco International (SFO) over the next 48 hours: 6-hour risk scores from forecast wind gusts, convective potential, winter and sustained precipitation, and heavy cloud cover at the field. Same shape as the generic delay-risk endpoint, bound to SFO.

Parameters

None.

Example

curl "https://x402-factory.com/v1/aviation/delay-risk/SFO"

Example response

{
  "data": {
    "blocks": [
      {
        "window_start": "2026-07-18T12:00:00.000Z",
        "window_end": "2026-07-18T17:00:00.000Z",
        "risk_score": 0.04,
        "drivers": []
      },
      {
        "window_start": "2026-07-18T18:00:00.000Z",
        "window_end": "2026-07-18T23:00:00.000Z",
        "risk_score": 0.22,
        "drivers": [
          "gusty_winds"
        ]
      },
      {
        "window_start": "2026-07-19T00:00:00.000Z",
        "window_end": "2026-07-19T05:00:00.000Z",
        "risk_score": 0.22,
        "drivers": [
          "gusty_winds"
        ]
      },
      {
        "window_start": "2026-07-19T06:00:00.000Z",
        "window_end": "2026-07-19T11:00:00.000Z",
        "risk_score": 0.04,
        "drivers": []
      }
    ],
    "verdict": "Low delay risk at SFO over the next 24 hours."
  },
  "meta": {
    "endpoint": "/v1/aviation/delay-risk/SFO",
    "version": "1.0.0",
    "generated_at": "2026-09-13T09:52:16.401Z",
    "freshness": "realtime",
    "sources": [
      "stub-model"
    ],
    "request_id": "req_00000000",
    "docs": "https://x402-factory.com/docs/weather.aviation.sfo",
    "data_mode": "live"
  }
}

Response schema (data payload)

{
  "type": "object",
  "properties": {
    "blocks": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "window_start": {
            "type": "string"
          },
          "window_end": {
            "type": "string"
          },
          "risk_score": {
            "type": "number",
            "minimum": 0,
            "maximum": 1
          },
          "drivers": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        },
        "required": [
          "window_start",
          "window_end",
          "risk_score",
          "drivers"
        ],
        "additionalProperties": false
      }
    },
    "verdict": {
      "type": "string"
    }
  },
  "required": [
    "blocks",
    "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.