Skip to content

Weather market board (all cities)

$0.10 per callUSDC via x402POST /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 GEFS) and the forecast probability of each bracket on a ladder. Send POST /api/weather-market-board with no required fields (6 optional) and pay $0.10 per call over x402 or MPP (there is no free tier). It returns a JSON object with date, variable, unit, rounding, count and 5 more.

Default: 13 large US cities, or send up to 20 by name or lat/lon, with your own brackets and the market prices you hold, shown beside each probability. This tool reads no market feed and gives facts only, no rating or recommendation. Raw model output, not station-calibrated. Weather data by Open-Meteo.com (CC BY 4.0).

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

Try in playground →

Parameters

NameTypeRequiredDescription
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)
unitsstringnofahrenheit (default here; wind in mph) or celsius (wind in km/h); precipitation is always mm
widthnumbernoWidth of each built ladder bracket in whole units, 1-50 (default 2 for temperature, 5 otherwise)
roundingstringnointeger (default here: member values are rounded to whole units before counting) or none; with none, only brackets you send are counted exactly as given
citiesarray of objectnoUp to 20 cities (default: 13 large US cities). Each: { label, place } or { label, lat, lon }, and optionally brackets [{ label, min, max, price }] to use in place of the built ladder

Example request

curl -i -X POST https://agent402.tools/api/weather-market-board \
  -H "Content-Type: application/json" \
  -d '{"variable":"temperature_max","units":"fahrenheit","cities":[{"label":"New York","lat":40.7128,"lon":-74.006},{"label":"Chicago","lat":41.8781,"lon":-87.6298},{"label":"Miami","lat":25.7617,"lon":-80.1918}]}'

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

Example response

{
  "date": "2026-11-18",
  "variable": "temperature_max",
  "unit": "°F",
  "rounding": "integer",
  "count": 3,
  "cities": [
    {
      "label": "New York",
      "lat": 40.7128,
      "lon": -74.006,
      "timezone": "America/New_York",
      "members": {
        "total": 82,
        "byModel": [
          {
            "model": "ECMWF IFS ensemble",
            "members": 51
          },
          {
            "model": "NOAA GEFS ensemble",
            "members": 31
          }
        ]
      },
      "distribution": {
        "min": 38.6,
        "p10": 41.9,
        "p25": 43.6,
        "median": 45.8,
        "p75": 47.9,
        "p90": 50.3,
        "max": 53.1,
        "mean": 45.9,
        "stdDev": 3.02
      },
      "brackets": [
        {
          "label": "41 or below",
          "min": null,
          "max": 41,
          "forecastProbability": 0.0732,
          "membersIn": 6
        },
        {
          "label": "42 to 43",
          "min": 42,
          "max": 43,
          "forecastProbability": 0.1707,
          "membersIn": 14
        },
        {
          "label": "44 to 45",
          "min": 44,
          "max": 45,
          "forecastProbability": 0.2317,
          "membersIn": 19
        },
        {
          "label": "46 or above",
          "min": 46,
          "max": null,
          "forecastProbability": 0.5244,
          "membersIn": 43
        }
      ],
      "membersOutsideBrackets": 0
    }
  ],
  "citiesNote": "Default cities are read at a city-center point. A market that settles on one station's reading can differ: send that station's lat and lon in cities.",
  "marketPriceNote": "marketPrice is the number the caller sent for that bracket, shown beside forecastProbability. This tool reads no market feed and makes no comparison or recommendation.",
  "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
datestringyes2026-11-18
variablestringyestemperature_max
unitstringyes°F
roundingstringyesinteger
countnumberyes3
citiesarray of objectsyes1 item in the example
citiesNotestringyesDefault cities are read at a city-center point. A market that settles on one ...
marketPriceNotestringyesmarketPrice is the number the caller sent for that bracket, shown beside fore...
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-market-board",
  "params": {
    "variable": "temperature_max",
    "units": "fahrenheit",
    "cities": [
      {
        "label": "New York",
        "lat": 40.7128,
        "lon": -74.006
      },
      {
        "label": "Chicago",
        "lat": 41.8781,
        "lon": -87.6298
      },
      {
        "label": "Miami",
        "lat": 25.7617,
        "lon": -80.1918
      }
    ]
  }
}

The hosted connector at https://agent402.tools/mcp needs a payment for weather-market-board; 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.10" }); // 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-market-board", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    "variable": "temperature_max",
    "units": "fahrenheit",
    "cities": [
      {
        "label": "New York",
        "lat": 40.7128,
        "lon": -74.006
      },
      {
        "label": "Chicago",
        "lat": 41.8781,
        "lon": -87.6298
      },
      {
        "label": "Miami",
        "lat": 25.7617,
        "lon": -80.1918
      }
    ]
  }),
});

Related tools

Weather market brackets (ensemble)

$0.02POST /api/weather-market-brackets

Forecast probability for every bracket of a weather market.

Weather probability (ensemble)

$0.01GET /api/weather-probability

Probability that a day's weather meets a condition, from up to 82 ensemble members (ECMWF IFS and NOAA GEFS): a high.

Current weather (global)

$0.002GET /api/weather-current

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

Kalshi city temperature index

$0.002POST /api/kalshi-weather-index

Kalshi's own minute-resolution city temperature index (Fahrenheit), the series its hourly temperature markets settle.

Heat index and wind chill calculator

FREE w/ computeor $0.001GET /api/heat-index-calc

Heat index, wind chill, humidex, dew point and wet-bulb temperature from the temperature, humidity and wind you supply.

Air quality (global)

$0.002GET /api/weather-air-quality

Air quality index and current pollutant concentrations for any location: US AQI, PM2.5, PM10, ozone, NO2, SO2, CO.