docsraw-datahourly-snapshot

Hourly Snapshot

GET/api/v1/data/hourly-snapshot

Single NWS run: all hourly predictions plus observations for a station at a point in time. Returns one scraper run's hourly forecast and observed values. Use reference_time and lookback_hours to target a specific run.

Parameters

Name	Type	Required	Description
`station_id`	string	required	ICAO station identifier (or use city)
`city`	string	optional	City name (resolves to station)
`reference_time`	ISO8601	optional	Anchor time (default: now)
`lookback_hours`	integer	optional	Hours before reference to find run (0–168) Default: 6

Response Fields

Field	Type	Description
`data`	array	Hourly records from the run
`data[].revision_count`	integer	Number of distinct forecast model runs targeting this hour
`data[].revision_std_dev`	float\|null	Std dev of forecast values across model runs (null if < 2 revisions)
`data[].forecast_min`	float\|null	Lowest forecast value across all model runs for this hour
`data[].forecast_max`	float\|null	Highest forecast value across all model runs for this hour
`run_created_at`	string	NWS run timestamp (ISO 8601)
`metadata.station_id`	string	Station identifier
`metadata.lookback_hours`	integer	Lookback used to find run

← Hourly Comparison

Forecast Run Stats →

cURL

curl -s -H "Authorization: Bearer $API_KEY" "https://api.deltadaemon.com/api/v1/data/hourly-snapshot?station_id=KBOS&lookback_hours=6"

JSON

{
  "success": true,
  "data": [
    {
      "station_id": "KBOS",
      "hour": "2026-02-22T14:00:00Z",
      "obs_high_f": 42.1,
      "forecast_f": 43.0,
      "adjusted_f": 42.5,
      "error_f": 0.9,
      "bias_f": 0.5,
      "std_dev_f": 2.1,
      "sample_size": 87,
      "conditions": "Partly Cloudy",
      "local_date": "2026-02-22",
      "local_hour": 9,
      "revision_count": 3,
      "revision_std_dev": 1.2,
      "forecast_min": 41.0,
      "forecast_max": 44.0
    }
  ],
  "run_created_at": "2026-02-22T02:00:00Z",
  "metadata": {
    "generated_at": "2026-02-22T08:00:00Z",
    "total_records": 1,
    "station_id": "KBOS",
    "lookback_hours": 6
  }
}

cURL

curl -s -H "Authorization: Bearer $API_KEY" "https://api.deltadaemon.com/api/v1/data/hourly-snapshot?station_id=KBOS&lookback_hours=6"

JSON

{
  "success": true,
  "data": [
    {
      "station_id": "KBOS",
      "hour": "2026-02-22T14:00:00Z",
      "obs_high_f": 42.1,
      "forecast_f": 43.0,
      "adjusted_f": 42.5,
      "error_f": 0.9,
      "bias_f": 0.5,
      "std_dev_f": 2.1,
      "sample_size": 87,
      "conditions": "Partly Cloudy",
      "local_date": "2026-02-22",
      "local_hour": 9,
      "revision_count": 3,
      "revision_std_dev": 1.2,
      "forecast_min": 41.0,
      "forecast_max": 44.0
    }
  ],
  "run_created_at": "2026-02-22T02:00:00Z",
  "metadata": {
    "generated_at": "2026-02-22T08:00:00Z",
    "total_records": 1,
    "station_id": "KBOS",
    "lookback_hours": 6
  }
}