Skip to content

Weather probability (ensemble)

$0.01 per callUSDC via x402GET /api/weather-probabilityCached 10m

Probability that a day's weather meets a condition, from up to 82 ensemble members (ECMWF IFS and NOAA GEFS): a high, low, rain total or wind past a threshold or inside a range. Send GET /api/weather-probability with no required fields (11 optional) and pay $0.01 per call over x402 or MPP (there is no free tier). It returns a JSON object with lat, lon, date, timezone, variable and 8 more.

Returns the member share, per-model counts and the spread. Any place by coordinates or name, up to 15 days ahead (all 82 to about 13 days, then NOAA's 31). Raw model output, not station-calibrated. ?place=Chicago&variable=temperature_max&units=fahrenheit&op=gte&value=40. Weather data by Open-Meteo.com (CC BY 4.0).

Category: Live public dataTags: weather probability ensemble forecast temperature prediction-market

Try in playground →

Parameters

NameTypeRequiredDescription
latnumbernoLatitude, -90 to 90 (with lon; wins over place)
lonnumbernoLongitude, -180 to 180 (with lat)
placestringnoA city, town or region name instead of lat/lon, for example "Paris" or "Austin, TX" (not a street address); the answer echoes the place it resolved to
datestringnoLocal date at the place, YYYY-MM-DD, up to 15 days ahead (default tomorrow, UTC); all 82 members reach about 13 days, the 31 NOAA members the rest
variablestringnoDaily value: temperature_max, temperature_min, temperature_mean, precipitation_sum, wind_speed_max (default temperature_max)
unitsstringnocelsius (default; wind in km/h) or fahrenheit (wind in mph); precipitation is always mm
opstringnoThreshold comparison: >=, >, <= or < (or gte, gt, lte, lt; default >=), with value
valuenumbernoThreshold in the variable's unit, with op
minnumbernoRange lower end (included), instead of op/value
maxnumbernoRange upper end (included), instead of op/value
roundingstringnonone (default) or integer: round each member's value to a whole unit before counting, for brackets stated in whole degrees

Example request

curl -i "https://agent402.tools/api/weather-probability?lat=41.8781&lon=-87.6298&variable=temperature_max&units=fahrenheit&op=%3E%3D&value=40"

Without payment this returns HTTP 402 Payment Required with the exact price for weather-probability; any x402 v2 or MPP client pays it and retries.

Example response

{
  "lat": 41.8781,
  "lon": -87.6298,
  "date": "2026-11-18",
  "timezone": "America/Chicago",
  "variable": "temperature_max",
  "unit": "°F",
  "condition": {
    "op": ">=",
    "value": 40
  },
  "rounding": "none",
  "probability": 0.7195,
  "members": {
    "total": 82,
    "meeting": 59,
    "byModel": [
      {
        "model": "ECMWF IFS ensemble",
        "members": 51,
        "meeting": 39,
        "probability": 0.7647
      },
      {
        "model": "NOAA GEFS ensemble",
        "members": 31,
        "meeting": 20,
        "probability": 0.6452
      }
    ]
  },
  "distribution": {
    "min": 36.2,
    "p10": 38.4,
    "p25": 39.7,
    "median": 41.3,
    "p75": 42.8,
    "p90": 44.1,
    "max": 46.5,
    "mean": 41.2,
    "stdDev": 2.14
  },
  "method": "Each probability is the share of ensemble members whose value for the date meets the condition. Raw model output at the model grid point, not calibrated to a weather station.",
  "source": "computed from Open-Meteo ensemble data, ensemble-api.open-meteo.com (CC BY 4.0)"
}
FieldTypeAlways presentIn the example
latnumberyes41.8781
lonnumberyes-87.6298
datestringyes2026-11-18
timezonestringyesAmerica/Chicago
variablestringyestemperature_max
unitstringyes°F
conditionobjectyes2 fields: op, value
roundingstringyesnone
probabilitynumberyes0.7195
membersobjectyes3 fields: total, meeting, byModel
distributionobjectyes9 fields: min, p10, p25, median, p75, p90 and 3 more
methodstringyesEach probability is the share of ensemble members whose value for the date me...
sourcestringyescomputed from Open-Meteo ensemble data, ensemble-api.open-meteo.com (CC BY 4.0)

From an MCP client

catalog.call {
  "slug": "weather-probability",
  "params": {
    "lat": 41.8781,
    "lon": -87.6298,
    "variable": "temperature_max",
    "units": "fahrenheit",
    "op": ">=",
    "value": 40
  }
}

The hosted connector at https://agent402.tools/mcp needs a payment for weather-probability; the stdio package pays it from a wallet or from an AGENT402_CREDITS_KEY issued earlier. Local install: npx -y agent402-mcp@0.13.32.

Errors and behavior

Paid call (JavaScript agent)

import { wrapFetchWithPayment } from "@x402/fetch";
import { x402Client } from "@x402/core/client";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

const client = new x402Client();
client.setSpendControls?.({ maxAmountPerPayment: "$0.01" }); // refuse any quote above this tool's price
registerExactEvmScheme(client, { signer: privateKeyToAccount(KEY) });
const payFetch = wrapFetchWithPayment(fetch, client);

const res = await payFetch("https://agent402.tools/api/weather-probability?lat=41.8781&lon=-87.6298&variable=temperature_max&units=fahrenheit&op=%3E%3D&value=40");

Related tools

Weather market board (all cities)

$0.10POST /api/weather-market-board

One date, many cities: per city, the ensemble spread of a daily weather value (up to 82 members, ECMWF IFS and NOAA.

Weather market brackets (ensemble)

$0.02POST /api/weather-market-brackets

Forecast probability for every bracket of a weather market.

Current weather (global)

$0.002GET /api/weather-current

Current weather conditions for any location on Earth: temperature, feels-like, humidity, wind speed/direction/gusts.

Daily forecast (global)

$0.002GET /api/weather-daily

7-day daily weather forecast for any location: high/low temp, precipitation sum and probability, max wind, UV index.

Weather forecast (US)

$0.001GET /api/weather-forecast

Multi-period weather forecast for a US location from api.weather.gov (NWS, public domain).

Hourly forecast (global)

$0.002GET /api/weather-hourly

48-hour hourly weather forecast for any location: temperature, precipitation probability and amount, wind, cloud cover.