docsadvancedtemperature-buckets

Temperature Buckets

GET/api/v1/accuracy/by-bucket/:station_id

Accuracy by 2°F temperature range. Returns hit rates, false positives, and false negatives for each bucket. Directly maps to prediction market contract ranges — shows which 2-degree bands NWS reliably predicts versus where it misses.

Parameters

NameTypeRequiredDescription
station_idpathrequiredICAO station identifier
daysintegeroptionalRolling window Default: 90
metricstringoptionalhigh (default) or low — bucket by forecast/actual low Default: high

Response Fields

FieldTypeDescription
temperature_rangestringBucket label (e.g., 74-76°F)
range_low_fintegerBucket lower bound °F
range_high_fintegerBucket upper bound °F
times_actual_in_rangeintegerDays actual high was in this bucket
times_forecast_in_rangeintegerDays forecast high was in this bucket
times_both_in_rangeintegerDays both forecast and actual in bucket
accuracy_when_forecast_in_rangefloatHit rate when forecast was in bucket (0-1)
frequency_pctfloatShare of days actual was in this bucket
cURL
curl -s -H "Authorization: Bearer $API_KEY" "https://api.deltadaemon.com/api/v1/accuracy/by-bucket/KLAX?days=90"
JSON
{
"success": true,
"data": [
{
"temperature_range": "32-34°F",
"range_low_f": 32,
"range_high_f": 34,
"times_actual_in_range": 12,
"times_forecast_in_range": 12,
"times_both_in_range": 9,
"accuracy_when_forecast_in_range": 0.75,
"frequency_pct": 25.53
},
{
"temperature_range": "36-38°F",
"range_low_f": 36,
"range_high_f": 38,
"times_actual_in_range": 23,
"times_forecast_in_range": 17,
"times_both_in_range": 9,
"accuracy_when_forecast_in_range": 0.53,
"frequency_pct": 48.94
}
],
"metadata": {
"generated_at": "2026-02-22T07:57:34.500455333Z",
"local_generated_at": "2026-02-22T02:57:34-05:00",
"days_analyzed": 30,
"station_id": "KBOS",
"station_timezone": "America/New_York"
}
}