docsadvancedpeak-timing

Peak Timing

GET/api/v1/accuracy/peak-timing/:station_id

When daily high or low temperatures typically occur at a station (metric=high vs metric=low). Returns the hour-by-hour distribution of observed timing and the median peak hour.

Parameters

Name	Type	Required	Description
`station_id`	path	required	ICAO station identifier
`days`	integer	optional	Rolling window Default: 90
`metric`	string	optional	high (default) or low — use low_observed_at for daily min timing Default: high

Response Fields

Field	Type	Description
`station_id`	string	ICAO station identifier
`station_timezone`	string	IANA timezone
`peak_time_distribution`	object	Time (HH:MM) → percentage mapping
`median_peak_hour`	integer	Most common peak hour (0-23)
`median_peak_time_local`	string	Formatted local time (e.g., 14:00)
`sample_count`	integer	Days analyzed

← Temperature Buckets

Exceedance →

cURL

curl -s -H "Authorization: Bearer $API_KEY" "https://api.deltadaemon.com/api/v1/accuracy/peak-timing/KLAX?days=90"

JSON

{
  "success": true,
  "data": {
    "station_id": "KBOS",
    "city_name": "Boston",
    "station_timezone": "America/New_York",
    "peak_time_distribution": { "00:00": 40, "10:00": 20, "11:00": 20, "20:00": 20 },
    "median_peak_hour": 11,
    "median_peak_time_local": "11:00",
    "sample_count": 5
  },
  "metadata": {
    "generated_at": "2026-02-22T07:58:39.03848241Z",
    "local_generated_at": "2026-02-22T02:58:39-05:00",
    "days_analyzed": 30,
    "station_id": "KBOS",
    "station_timezone": "America/New_York"
  }
}

cURL

curl -s -H "Authorization: Bearer $API_KEY" "https://api.deltadaemon.com/api/v1/accuracy/peak-timing/KLAX?days=90"

JSON

{
  "success": true,
  "data": {
    "station_id": "KBOS",
    "city_name": "Boston",
    "station_timezone": "America/New_York",
    "peak_time_distribution": { "00:00": 40, "10:00": 20, "11:00": 20, "20:00": 20 },
    "median_peak_hour": 11,
    "median_peak_time_local": "11:00",
    "sample_count": 5
  },
  "metadata": {
    "generated_at": "2026-02-22T07:58:39.03848241Z",
    "local_generated_at": "2026-02-22T02:58:39-05:00",
    "days_analyzed": 30,
    "station_id": "KBOS",
    "station_timezone": "America/New_York"
  }
}