docsraw-dataforecast-actual-pairs

Forecast-Actual Pairs

GET/api/v1/data/forecast-actual

Raw forecast vs actual verification pairs. Each record contains station, dates, forecast/actual temperatures, error, and lead time. Supports CSV export for custom analysis. Max 5,000 records per request.

Parameters

Name	Type	Required	Description
`station_id`	string	optional	Filter to one station
`city`	string	optional	Filter by city name
`days`	integer	optional	Rolling window Default: 90
`date_from`	YYYY-MM-DD	optional	Window start (with date_to)
`date_to`	YYYY-MM-DD	optional	Window end (with date_from)
`limit`	integer	optional	Max records (max 5000) Default: 1000
`format`	string	optional	json or csv Default: json

Response Fields

Field	Type	Description
`station_id`	string	ICAO station identifier
`forecast_for_date`	string	Target calendar date
`forecast_created_at`	string	When the forecast was issued (ISO 8601)
`forecast_high_f`	float	Forecast daily high °F
`actual_high_f`	float	Observed daily high °F
`error_f`	float	forecast - observed °F (per error_convention)
`hours_before_target_date`	float	Hours between issue and valid date midnight
`forecast_timing`	string	Lead time bucket: day_ahead, 2_days_ahead, etc.
`verification_status`	string	verified or preliminary
`verification_source`	string	running_observation or weather_daily_highs

← Update Frequency

Forecast Snapshots →

cURL

# JSON
curl -s -H "Authorization: Bearer $API_KEY" "https://api.deltadaemon.com/api/v1/data/forecast-actual?station_id=KLAX&days=7&limit=3"

# CSV export
curl -s -H "Authorization: Bearer $API_KEY" "https://api.deltadaemon.com/api/v1/data/forecast-actual?station_id=KLAX&date_from=2026-01-01&date_to=2026-01-31&format=csv" -o klax_jan.csv

JSON

{
  "success": true,
  "data": [
    {
      "station_id": "KBOS",
      "forecast_for_date": "2026-02-22",
      "forecast_created_at": "2026-02-21T07:30:01Z",
      "forecast_high_f": 35,
      "actual_high_f": 30.2,
      "error_f": 4.8,
      "hours_before_target_date": 21.5,
      "forecast_timing": "day_ahead",
      "verification_status": "preliminary",
      "verification_source": "running_observation"
    }
  ],
  "metadata": {
    "generated_at": "2026-02-22T07:53:39.519654411Z",
    "period_start": "2026-02-15",
    "period_end": "2026-02-22",
    "total_records": 3,
    "query_time_ms": 0,
    "station_id": "KBOS",
    "station_timezone": "America/New_York",
    "error_convention": "forecast_minus_actual"
  }
}

cURL

# JSON
curl -s -H "Authorization: Bearer $API_KEY" "https://api.deltadaemon.com/api/v1/data/forecast-actual?station_id=KLAX&days=7&limit=3"

# CSV export
curl -s -H "Authorization: Bearer $API_KEY" "https://api.deltadaemon.com/api/v1/data/forecast-actual?station_id=KLAX&date_from=2026-01-01&date_to=2026-01-31&format=csv" -o klax_jan.csv

JSON

{
  "success": true,
  "data": [
    {
      "station_id": "KBOS",
      "forecast_for_date": "2026-02-22",
      "forecast_created_at": "2026-02-21T07:30:01Z",
      "forecast_high_f": 35,
      "actual_high_f": 30.2,
      "error_f": 4.8,
      "hours_before_target_date": 21.5,
      "forecast_timing": "day_ahead",
      "verification_status": "preliminary",
      "verification_source": "running_observation"
    }
  ],
  "metadata": {
    "generated_at": "2026-02-22T07:53:39.519654411Z",
    "period_start": "2026-02-15",
    "period_end": "2026-02-22",
    "total_records": 3,
    "query_time_ms": 0,
    "station_id": "KBOS",
    "station_timezone": "America/New_York",
    "error_convention": "forecast_minus_actual"
  }
}