Weather market board (all cities)
POST /api/weather-market-boardOne 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).
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
date | string | no | Local 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 |
variable | string | no | Daily value: temperature_max, temperature_min, temperature_mean, precipitation_sum, wind_speed_max (default temperature_max) |
units | string | no | fahrenheit (default here; wind in mph) or celsius (wind in km/h); precipitation is always mm |
width | number | no | Width of each built ladder bracket in whole units, 1-50 (default 2 for temperature, 5 otherwise) |
rounding | string | no | integer (default here: member values are rounded to whole units before counting) or none; with none, only brackets you send are counted exactly as given |
cities | array of object | no | Up 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)"
}| Field | Type | Always present | In the example |
|---|---|---|---|
date | string | yes | 2026-11-18 |
variable | string | yes | temperature_max |
unit | string | yes | °F |
rounding | string | yes | integer |
count | number | yes | 3 |
cities | array of objects | yes | 1 item in the example |
citiesNote | string | yes | Default cities are read at a city-center point. A market that settles on one ... |
marketPriceNote | string | yes | marketPrice is the number the caller sent for that bracket, shown beside fore... |
method | string | yes | Each probability is the share of ensemble members whose value for the date me... |
source | string | yes | computed 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
- Every field is optional. An input the tool rejects returns an HTTP 4xx whose body carries
error,tool,expected,requiredandexample. - A paid call that ends in any status of 400 or above is not charged over x402, MPP or a prepaid credits key: settlement runs after the tool and only on a successful response. The exception is a Tempo push credential, a transfer the buyer sent before the call: it settles before the tool runs, so if the tool then fails the payment is recorded as a refund owed to the paying wallet.
- Wallet-only: this tool reaches the network or stored state, so it has no proof-of-work tier. A prepaid card-credits key issued earlier (
Authorization: Bearer a402_...) also pays it. - A
GETorHEADto /api/weather-market-board returns the same 402 quote, so the price can be read without a body. - An
Idempotency-Keyheader makes a retried paid call replay the first 200 instead of charging again (an answer larger than 1 MB is not replayed).
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)
Forecast probability for every bracket of a weather market.
Weather probability (ensemble)
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)
Current weather conditions for any location on Earth: temperature, feels-like, humidity, wind speed/direction/gusts.
Kalshi city temperature index
Kalshi's own minute-resolution city temperature index (Fahrenheit), the series its hourly temperature markets settle.
Heat index and wind chill calculator
Heat index, wind chill, humidex, dew point and wet-bulb temperature from the temperature, humidity and wind you supply.
Air quality (global)
Air quality index and current pollutant concentrations for any location: US AQI, PM2.5, PM10, ozone, NO2, SO2, CO.