Catalog/data-weather-extremes

Data

Weather records for a day-of-year API

For a lat/lon and calendar date, pull the full Open-Meteo archive (1940-present, keyless) and compute the all-time record high, record low, and max daily precipitation observed on that day-of-year across every year (with the years they were set); optionally rank a supplied value against the historical distribution. The value-add is the all-time records derivation. Differs from data-climate-normal (anomaly vs 30-year mean). Answers 'what is the record high for this day here', 'hottest June 3 on record', 'is today a record', 'max rainfall ever on this date'.

Price$0.01per request
MethodPOST
Route/v1/data/weather-extremes
StatusLive
MIME typeapplication/json
Rate limit60/minute
Cache3600s public
dataweatherrecordsextremesclimatehistorytemperatureprecipitation
API URLhttps://x402.hexl.dev/v1/data/weather-extremes
Integration docs
Example request
{
  "latitude": 40.71,
  "longitude": -74.01,
  "date": "2026-06-03",
  "value": 38
}
Example response
{
  "latitude": 40.71,
  "longitude": -74.01,
  "date": "2026-06-03",
  "yearsOfRecord": 85,
  "recordHighC": 37.2,
  "recordHighYear": 1925,
  "recordLowC": 7.8,
  "recordLowYear": 1945,
  "maxPrecipMm": 64.5,
  "maxPrecipYear": 1984,
  "meanHighC": 26.3,
  "rankedValueC": 38,
  "warmerThanPctOfYears": 98.8,
  "isRecordHigh": true,
  "verdict": "new record high"
}
Input schema
{
  "type": "object",
  "required": [
    "latitude",
    "longitude"
  ],
  "properties": {
    "latitude": {
      "type": "number",
      "examples": [
        40.71
      ]
    },
    "longitude": {
      "type": "number",
      "examples": [
        -74.01
      ]
    },
    "date": {
      "type": "string",
      "examples": [
        "2026-06-03"
      ]
    },
    "value": {
      "type": "number",
      "examples": [
        38
      ]
    }
  }
}
Output schema
{
  "type": "object",
  "additionalProperties": true
}