Skip to main content
Glama

groundhog.markets

Weather markets

markets
Read-onlyIdempotent

Kalshi and Polymarket weather markets (high, low, rain) in a place: settlement station and rule, the value so far under that rule, forecast daily max/min (or rain) at the station, our value and the official result once settled. No prices: read them from the venue (each row's event and event_url). Needs place, family or venue. line ≈526 tok, table ≈1,757; every city ≈36,291. With none: the list of market cities. format=json also returns structuredContent; the JSON Schema is at https://groundhog.markets/api/v1/schema.json

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "markets"
  }
}

Input Schema

NameRequiredDescriptionDefault
dateNotoday | tomorrow | yesterday | YYYY-MM-DD, each place's local date (default today)
sizeNoline (default with place) | table (default without)
placeNoSlug, name, 'City, ST' or ICAO; an array for up to 10 places
venueNokalshi | polymarket (default both); alone: every market of that venue
familyNohigh | low | rain | all (default all); alone: every market city
fieldsNofull (default) | compact: leave out null JSON keys (format=json)
formatNoline md, table tsv
compactNotrue = fields=compact
creditsNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed3 schema fields changed
    • addedInput schema / properties / compact
      Added value: +{
      +  "description": "true = fields=compact",
      +  "type": "boolean"
      +}
    • changedInput schema / properties / fields / description
      Previous value: -"full (default) | compact: leave out null members of the JSON (structuredContent and format=json)"New value: +"full (default) | compact: leave out null JSON keys (format=json)"
    • changedOutput schema / (root)
      Previous value: -{
      -  "anyOf": [
      -    {
      -      "additionalProperties": false,
      -      "properties": {
      -        "asof": {
      -          "description": "Request time (UTC).",
      -          "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}Z$",
      -          "type": "string"
      -        },
      -        "build": {
      -          "description": "The running commit, 7 hex (dev off Tokay). With method, ties this body's numbers to the code and rules that made them (CONTRACTS §51).",
      -          "type": "string"
      -        },
      -        "credit_keys": {
      -          "description": "Their keys (/credits lists every line).",
      -          "items": {
      -            "type": "string"
      -          },
      -          "type": "array"
      -        },
      -        "credits": {
      -          "description": "Credit strings to keep when you repeat numbers.",
      -          "items": {
      -            "type": "string"
      -          },
      -          "type": "array"
      -        },
      -        "credits_url": {
      -          "description": "The full credits page.",
      -          "type": "string"
      -        },
      -        "date": {
      -          "description": "today | tomorrow | yesterday | YYYY-MM-DD, each place's local date. Default today: the market's own day at any hour (no 15:00 roll to tomorrow as /blend has); ask tomorrow for the next day's markets.",
      -          "type": "string"
      -        },
      -        "family": {
      -          "description": "Family asked for.",
      -          "enum": [
      -            "high",
      -            "low",
      -            "rain",
      -            "all"
      -          ]
      -        },
      -        "kind": {
      -          "const": "markets",
      -          "description": "Body kind."
      -        },
      -        "method": {
      -          "description": "Method id: the contract rules that made this body's numbers (blend-median-v1, rain-month-v5, markets-nbm-led-v4, receipts-qa-v1, history-as-issued-v3, status-readiness-v1). A rule change gives a new id, so equal ids mean the same method (CONTRACTS §51).",
      -          "type": "string"
      -        },
      -        "notes": {
      -          "description": "Sentences about this answer; always ends with \"No prices.\".",
      -          "items": {
      -            "type": "string"
      -          },
      -          "type": "array"
      -        },
      -        "places": {
      -          "description": "The places answered (the index: every market city with a row).",
      -          "items": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "date": {
      -                "description": "Its local date for `date`.",
      -                "type": "string"
      -              },
      -              "display": {
      -                "description": "Display name.",
      -                "type": "string"
      -              },
      -              "n_rows": {
      -                "description": "Its rows in this body.",
      -                "type": "integer"
      -              },
      -              "slug": {
      -                "description": "Place slug (a lat,lon for a point).",
      -                "type": "string"
      -              },
      -              "url": {
      -                "description": "Its page.",
      -                "type": [
      -                  "string",
      -                  "null"
      -                ]
      -              },
      -              "when": {
      -                "description": "today | tomorrow | yesterday | +N | past.",
      -                "type": "string"
      -              }
      -            },
      -            "required": [
      -              "slug",
      -              "display",
      -              "date",
      -              "when",
      -              "n_rows"
      -            ],
      -            "type": "object"
      -          },
      -          "type": "array"
      -        },
      -        "rows": {
      -          "description": "One row per venue x family x kind.",
      -          "items": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "agree": {
      -                "description": "Ours vs the venue's result for this event.",
      -                "enum": [
      -                  "match",
      -                  "differs",
      -                  null
      -                ]
      -              },
      -              "agree_30d": {
      -                "description": "m/n matches over 30 days once the product passes the claim gate; else null. Pools both venues and every city of the row's product and rule version; agree_30d_detail is the row's own venue, with dates.",
      -                "type": [
      -                  "string",
      -                  "null"
      -                ]
      -              },
      -              "agree_30d_detail": {
      -                "anyOf": [
      -                  {
      -                    "additionalProperties": false,
      -                    "properties": {
      -                      "checked": {
      -                        "description": "Events checked (match or differs) for this venue, product and rule version, every city.",
      -                        "type": "integer"
      -                      },
      -                      "days": {
      -                        "description": "Distinct event dates among them.",
      -                        "type": "integer"
      -                      },
      -                      "last_date": {
      -                        "description": "The newest checked event date (YYYY-MM-DD, monthly YYYY-MM): a Kalshi count stops at 10/29 (no Kalshi request since, CONTRACTS §33).",
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "match": {
      -                        "description": "Matches; null until the product has the claim minimum of checked events.",
      -                        "type": [
      -                          "integer",
      -                          "null"
      -                        ]
      -                      },
      -                      "scope": {
      -                        "const": "venue+product+rule_from",
      -                        "description": "What the count pools: every city of the row's venue, product and rule version, not this city alone."
      -                      }
      -                    },
      -                    "required": [
      -                      "checked",
      -                      "days",
      -                      "scope"
      -                    ],
      -                    "type": "object"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "description": "agree_30d split by venue, with its dates; null while nothing is checked."
      -              },
      -              "at": {
      -                "description": "UTC time of the report that set so_far (ISO).",
      -                "type": [
      -                  "string",
      -                  "null"
      -                ]
      -              },
      -              "bound": {
      -                "description": "What the result can still be given so far: >=61, <=44, >=1.42.",
      -                "type": [
      -                  "string",
      -                  "null"
      -                ]
      -              },
      -              "date": {
      -                "description": "The venue's date for this market: YYYY-MM-DD, YYYY-MM (monthly) or YYYY.",
      -                "type": "string"
      -              },
      -              "derived": {
      -                "description": "1 when the rule names a source we do not fetch and we compute the same number from the open source it shows.",
      -                "enum": [
      -                  0,
      -                  1,
      -                  null
      -                ]
      -              },
      -              "event": {
      -                "description": "Venue event id (Kalshi event ticker, Polymarket event slug).",
      -                "type": [
      -                  "string",
      -                  "null"
      -                ]
      -              },
      -              "event_url": {
      -                "description": "The event page (Kalshi: the series page).",
      -                "type": [
      -                  "string",
      -                  "null"
      -                ]
      -              },
      -              "fam": {
      -                "description": "Market family.",
      -                "enum": [
      -                  "high",
      -                  "low",
      -                  "rain"
      -                ]
      -              },
      -              "fc": {
      -                "description": "Forecast at the settlement station: daily max/min (fc_kind daily_extreme), or the chance in % (pop). The headline, the number to use (CONTRACTS §29; fc_by says where it comes from, method names the rule); the shadow fields are candidates, not the headline.",
      -                "type": [
      -                  "number",
      -                  "null"
      -                ]
      -              },
      -              "fc_alt": {
      -                "description": "Shadow. (fc_window, else fc) + fc_bias: a candidate forecast, not yet the served fc; null when neither applies. Archived as served and scored against settle values (CONTRACTS §56, §58).",
      -                "type": [
      -                  "number",
      -                  "null"
      -                ]
      -              },
      -              "fc_alt_by": {
      -                "description": "What fc_alt applied to fc.",
      -                "enum": [
      -                  "window",
      -                  "bias",
      -                  "window+bias",
      -                  null
      -                ]
      -              },
      -              "fc_bias": {
      -                "description": "Shadow. The correction added for fc_alt: minus the station's median error at this lead (1-3 days) and season, from the settled history, shrunk toward all stations; null without enough cases.",
      -                "type": [
      -                  "number",
      -                  "null"
      -                ]
      -              },
      -              "fc_by": {
      -                "description": "Where fc comes from: nbm = the station's NBM (NOAA National Blend of Models; Kalshi CLI days after today), blend = the median.",
      -                "enum": [
      -                  "nbm",
      -                  "blend",
      -                  null
      -                ]
      -              },
      -              "fc_issued_at": {
      -                "description": "high/low: the oldest run in fc_runs (UTC): the age of the oldest input behind fc. Null for rain and without a forecast (CONTRACTS §51).",
      -                "type": [
      -                  "string",
      -                  "null"
      -                ]
      -              },
      -              "fc_kind": {
      -                "description": "What fc is.",
      -                "enum": [
      -                  "daily_extreme",
      -                  "pop",
      -                  "rest_of_month",
      -                  null
      -                ]
      -              },
      -              "fc_left_h": {
      -                "description": "Rain: hours left in the climate day (rain.enabled); else null.",
      -                "type": [
      -                  "number",
      -                  "null"
      -                ]
      -              },
      -              "fc_n": {
      -                "description": "Forecasts (or model families) behind fc.",
      -                "type": [
      -                  "integer",
      -                  "null"
      -                ]
      -              },
      -              "fc_raw": {
      -                "description": "Temperature rows: fc as served (shadow fields below leave it unchanged); null on rain rows.",
      -                "type": [
      -                  "number",
      -                  "null"
      -                ]
      -              },
      -              "fc_rest": {
      -                "description": "Monthly rain: expected rest of month (mean).",
      -                "type": [
      -                  "number",
      -                  "null"
      -                ]
      -              },
      -              "fc_rest_p10": {
      -                "description": "Rain: rest-of-month 10th percentile (rain.enabled); else null.",
      -                "type": [
      -                  "number",
      -                  "null"
      -                ]
      -              },
      -              "fc_rest_p90": {
      -                "description": "Rain: rest-of-month 90th percentile (rain.enabled); else null.",
      -                "type": [
      -                  "number",
      -                  "null"
      -                ]
      -              },
      -              "fc_rest_p_ge": {
      -                "anyOf": [
      -                  {
      -                    "additionalProperties": {
      -                      "type": "integer"
      -                    },
      -                    "type": "object"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "description": "Monthly rain (rain.enabled): {line: chance %} for each strike line of the event's bins (bin lower edges, in unit): the chance the month total reaches the line as the venue counts it (a rain ladder's 'Above X': more than X): the venue's count, moved by the station's hourly rain to each ensemble's start, + its rest (members, then the station's 1991-2020 history). Null when the bins, the distribution or that hourly rain are unknown, and while markets.publish_probs is off (CONTRACTS §58)."
      -              },
      -              "fc_rest_thru": {
      -                "description": "Non-US: the rest-of-month forecast stops at this date.",
      -                "type": [
      -                  "string",
      -                  "null"
      -                ]
      -              },
      -              "fc_runs": {
      -                "anyOf": [
      -                  {
      -                    "items": {
      -                      "type": "string"
      -                    },
      -                    "type": "array"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "description": "Runs behind fc. high/low: each input's run or issue time (UTC ISO), aligned with fc_src. Rain: the run hour per family (HHZ, rain.enabled). Null without a forecast."
      -              },
      -              "fc_src": {
      -                "anyOf": [
      -                  {
      -                    "items": {
      -                      "type": "string"
      -                    },
      -                    "type": "array"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "description": "Inputs behind fc. high/low: the source ids (/api/v1/sources) whose values made fc, one per input (fc_n of them for a day's median; [\"nbm\"] when fc_by is nbm). Rain: model families (rain.enabled). Null without a forecast (CONTRACTS §51)."
      -              },
      -              "fc_window": {
      -                "description": "Shadow. Kalshi days after today with fc_by nbm: the NBM day on the market's midnight-to-midnight standard-time day (NBM's own windows are 19-08 for the low and 07-19 for the high), checked with that NBM cycle's 3-hourly temperatures; equals fc when the added hours do not change it; null when not checked.",
      -                "type": [
      -                  "number",
      -                  "null"
      -                ]
      -              },
      -              "final_cli": {
      -                "description": "Kalshi CLI rows whose window is over (settling, settled): true once ours is the first final NWS CLI, false before; null otherwise.",
      -                "type": [
      -                  "boolean",
      -                  "null"
      -                ]
      -              },
      -              "flag": {
      -                "description": "low_after_midnight: the low may come after midnight (Kalshi day to 1 am); provisional (rain): pop is 100 from rain recorded in METARs or a preliminary CLI, not the final report.",
      -                "type": [
      -                  "string",
      -                  "null"
      -                ]
      -              },
      -              "kind": {
      -                "description": "Market kind.",
      -                "enum": [
      -                  "day",
      -                  "weekend",
      -                  "month",
      -                  "season",
      -                  "once",
      -                  "window",
      -                  "year"
      -                ]
      -              },
      -              "market": {
      -                "description": "Kalshi: the market ticker of this city's market in a multi-city series (KXRAINWKND-26NOV14-CHI, KXRAIN-26NOV11-CHI), which `event` serves without the city code: the id Kalshi's own feeds use for this row. Null for a ladder event (one market per bin or line: join on event and the strike), for Polymarket (market ids not ingested: join on the event slug and the bin label) and without an event (CONTRACTS §60).",
      -                "type": [
      -                  "string",
      -                  "null"
      -                ]
      -              },
      -              "mtd": {
      -                "description": "Monthly rain: month to date.",
      -                "type": [
      -                  "number",
      -                  "null"
      -                ]
      -              },
      -              "mtd_through": {
      -                "description": "Last day inside mtd (YYYY-MM-DD).",
      -                "type": [
      -                  "string",
      -                  "null"
      -                ]
      -              },
      -              "n_obs": {
      -                "description": "Reports counted so far.",
      -                "type": [
      -                  "integer",
      -                  "null"
      -                ]
      -              },
      -              "note": {
      -                "description": "State text (rule changed, late), else null.",
      -                "type": [
      -                  "string",
      -                  "null"
      -                ]
      -              },
      -              "ours": {
      -                "description": "Our reconstructed settle value once the window is done.",
      -                "type": [
      -                  "number",
      -                  "null"
      -                ]
      -              },
      -              "ours_src": {
      -                "description": "Where ours comes from.",
      -                "enum": [
      -                  "group24",
      -                  "cli_final",
      -                  "cli_cor",
      -                  "rule",
      -                  null
      -                ]
      -              },
      -              "partial": {
      -                "description": "1 when an hour of the window has no routine report.",
      -                "enum": [
      -                  0,
      -                  1,
      -                  null
      -                ]
      -              },
      -              "place": {
      -                "description": "Slug of the market city.",
      -                "type": "string"
      -              },
      -              "pop": {
      -                "description": "Rain markets: chance of 0.01 in or more, %.",
      -                "type": [
      -                  "integer",
      -                  "null"
      -                ]
      -              },
      -              "product": {
      -                "description": "Settlement product (CLI_T, METAR_R, HKO_T, CLI_P, ...; /llms-full.txt has the glossary).",
      -                "type": "string"
      -              },
      -              "result": {
      -                "description": "The venue's official result as text in the market unit (61, 60-61, Yes).",
      -                "type": [
      -                  "string",
      -                  "null"
      -                ]
      -              },
      -              "result_src": {
      -                "description": "Where `result` comes from, or why there is none.",
      -                "type": [
      -                  "string",
      -                  "null"
      -                ]
      -              },
      -              "result_tracked": {
      -                "description": "True when groundhog reads this venue's results now; false for Kalshi (no Kalshi request, CONTRACTS §33): result stays null after 10/29.",
      -                "type": [
      -                  "boolean",
      -                  "null"
      -                ]
      -              },
      -              "rule": {
      -                "description": "Our one-line paraphrase of the rule (never venue text).",
      -                "type": [
      -                  "string",
      -                  "null"
      -                ]
      -              },
      -              "series_key": {
      -                "description": "groundhog's series key: the Kalshi series ticker, with the city's market code for a multi-city series (KXRAINWKND-CHI), or the Polymarket slug pattern; the key /api/v1/markets/coverage lists (CONTRACTS §60).",
      -                "type": "string"
      -              },
      -              "so_far": {
      -                "description": "The value so far under the venue's own rule (temperature, or rain total).",
      -                "type": [
      -                  "number",
      -                  "null"
      -                ]
      -              },
      -              "src_url": {
      -                "description": "The settlement product we read (NWS CLI product, AWC METAR API URL, ...).",
      -                "type": [
      -                  "string",
      -                  "null"
      -                ]
      -              },
      -              "state": {
      -                "description": "Where the market stands; upcoming = its measuring window has not started (it may be trading: trading_open).",
      -                "enum": [
      -                  "upcoming",
      -                  "open",
      -                  "settling",
      -                  "proposed",
      -                  "settled",
      -                  "rule_changed",
      -                  "late",
      -                  "link_only",
      -                  "no_data"
      -                ]
      -              },
      -              "stn": {
      -                "description": "Settlement station (ICAO or the source's station id).",
      -                "type": [
      -                  "string",
      -                  "null"
      -                ]
      -              },
      -              "trading_open": {
      -                "description": "Polymarket: true while the venue lists this event as open for trading (gamma: not closed), false once closed, proposed or settled; null without an event or while groundhog's Polymarket list is stale. Kalshi: null (no Kalshi request, CONTRACTS §33). Independent of state: a day-ahead market trades while its window is upcoming.",
      -                "type": [
      -                  "boolean",
      -                  "null"
      -                ]
      -              },
      -              "unit": {
      -                "description": "Unit of every value in this row (the venue's own).",
      -                "enum": [
      -                  "F",
      -                  "C",
      -                  "in",
      -                  "mm"
      -                ]
      -              },
      -              "url": {
      -                "description": "The market page (Kalshi series page, Polymarket event page).",
      -                "type": [
      -                  "string",
      -                  "null"
      -                ]
      -              },
      -              "venue": {
      -                "description": "Venue.",
      -                "enum": [
      -                  "kalshi",
      -                  "polymarket"
      -                ]
      -              },
      -              "win": {
      -                "description": "Rain: the window of fc (rain.enabled); else null.",
      -                "enum": [
      -                  "lst",
      -                  "cal",
      -                  null
      -                ]
      -              },
      -              "win_end": {
      -                "description": "Window end (UTC ISO).",
      -                "type": [
      -                  "string",
      -                  "null"
      -                ]
      -              },
      -              "win_start": {
      -                "description": "Window start (UTC ISO); null for link-only rows.",
      -                "type": [
      -                  "string",
      -                  "null"
      -                ]
      -              },
      -              "window_starts_in_h": {
      -                "description": "Hours until the measuring window starts (0.1 h); null once it has started or without a window. state upcoming = this is ahead.",
      -                "type": [
      -                  "number",
      -                  "null"
      -                ]
      -              }
      -            },
      -            "required": [
      -              "place",
      -              "venue",
      -              "fam",
      -              "kind",
      -              "date",
      -              "product",
      -              "unit",
      -              "state"
      -            ],
      -            "type": "object"
      -          },
      -          "type": "array"
      -        },
      -        "size": {
      -          "description": "line (per place) | table.",
      -          "enum": [
      -            "line",
      -            "table"
      -          ]
      -        },
      -        "url": {
      -          "description": "The page that shows this answer (the place page, else /markets).",
      -          "type": "string"
      -        },
      -        "v": {
      -          "const": 1,
      -          "description": "Body version."
      -        }
      -      },
      -      "required": [
      -        "v",
      -        "kind",
      -        "size",
      -        "asof",
      -        "family",
      -        "date",
      -        "places",
      -        "url",
      -        "rows",
      -        "notes",
      -        "credits",
      -        "credit_keys",
      -        "credits_url"
      -      ],
      -      "type": "object"
      -    },
      -    {
      -      "additionalProperties": false,
      -      "description": "markets() with none of place, family and venue: every market city.",
      -      "properties": {
      -        "kind": {
      -          "const": "market_cities",
      -          "description": "Body kind."
      -        },
      -        "n": {
      -          "description": "Cities.",
      -          "type": "integer"
      -        },
      -        "notes": {
      -          "description": "Ends with \"No prices.\".",
      -          "items": {
      -            "type": "string"
      -          },
      -          "type": "array"
      -        },
      -        "places": {
      -          "description": "Every market city, by slug.",
      -          "items": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "display": {
      -                "description": "Display name.",
      -                "type": [
      -                  "string",
      -                  "null"
      -                ]
      -              },
      -              "families": {
      -                "description": "Market families of the city.",
      -                "items": {
      -                  "enum": [
      -                    "high",
      -                    "low",
      -                    "rain"
      -                  ]
      -                },
      -                "type": "array"
      -              },
      -              "slug": {
      -                "description": "Pass as markets place.",
      -                "type": "string"
      -              },
      -              "venues": {
      -                "description": "Venues listing them.",
      -                "items": {
      -                  "enum": [
      -                    "kalshi",
      -                    "polymarket"
      -                  ]
      -                },
      -                "type": "array"
      -              }
      -            },
      -            "required": [
      -              "slug",
      -              "families",
      -              "venues"
      -            ],
      -            "type": "object"
      -          },
      -          "type": "array"
      -        },
      -        "v": {
      -          "const": 1,
      -          "description": "Body version."
      -        }
      -      },
      -      "required": [
      -        "v",
      -        "kind",
      -        "n",
      -        "places",
      -        "notes"
      -      ],
      -      "type": "object"
      -    }
      -  ],
      -  "description": "The JSON body (/api/v1/schema.json); fields=compact drops null members.",
      -  "type": "object"
      -}New value: +null
  2. Changed1 schema field changed
    • changedOutput schema / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "asof": {
      -        "description": "Request time (UTC).",
      -        "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}Z$",
      -        "type": "string"
      -      },
      -      "build": {
      -        "description": "The running commit, 7 hex (dev off Tokay). With method, ties this body's numbers to the code and rules that made them (CONTRACTS §51).",
      -        "type": "string"
      -      },
      -      "credit_keys": {
      -        "description": "Their keys (/credits lists every line).",
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "credits": {
      -        "description": "Credit strings to keep when you repeat numbers.",
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "credits_url": {
      -        "description": "The full credits page.",
      -        "type": "string"
      -      },
      -      "date": {
      -        "description": "today | tomorrow | yesterday | YYYY-MM-DD, each place's local date. Default today: the market's own day at any hour (no 15:00 roll to tomorrow as /blend has); ask tomorrow for the next day's markets.",
      -        "type": "string"
      -      },
      -      "family": {
      -        "description": "Family asked for.",
      -        "enum": [
      -          "high",
      -          "low",
      -          "rain",
      -          "all"
      -        ]
      -      },
      -      "kind": {
      -        "const": "markets",
      -        "description": "Body kind."
      -      },
      -      "method": {
      -        "description": "Method id: the contract rules that made this body's numbers (blend-median-v1, rain-month-v3, markets-nbm-led-v2, receipts-qa-v1, history-as-issued-v3, status-readiness-v1). A rule change gives a new id, so equal ids mean the same method (CONTRACTS §51).",
      -        "type": "string"
      -      },
      -      "notes": {
      -        "description": "Sentences about this answer; always ends with \"No prices.\".",
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "places": {
      -        "description": "The places answered (the index: every market city with a row).",
      -        "items": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "date": {
      -              "description": "Its local date for `date`.",
      -              "type": "string"
      -            },
      -            "display": {
      -              "description": "Display name.",
      -              "type": "string"
      -            },
      -            "n_rows": {
      -              "description": "Its rows in this body.",
      -              "type": "integer"
      -            },
      -            "slug": {
      -              "description": "Place slug (a lat,lon for a point).",
      -              "type": "string"
      -            },
      -            "url": {
      -              "description": "Its page.",
      -              "type": [
      -                "string",
      -                "null"
      -              ]
      -            },
      -            "when": {
      -              "description": "today | tomorrow | yesterday | +N | past.",
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "slug",
      -            "display",
      -            "date",
      -            "when",
      -            "n_rows"
      -          ],
      -          "type": "object"
      -        },
      -        "type": "array"
      -      },
      -      "rows": {
      -        "description": "One row per venue x family x kind.",
      -        "items": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "agree": {
      -              "description": "Ours vs the venue's result for this event.",
      -              "enum": [
      -                "match",
      -                "differs",
      -                null
      -              ]
      -            },
      -            "agree_30d": {
      -              "description": "m/n matches over 30 days once the product passes the claim gate; else null.",
      -              "type": [
      -                "string",
      -                "null"
      -              ]
      -            },
      -            "agree_30d_detail": {
      -              "anyOf": [
      -                {
      -                  "additionalProperties": false,
      -                  "properties": {
      -                    "checked": {
      -                      "description": "Events checked (match or differs) for this venue, product and rule version, every city.",
      -                      "type": "integer"
      -                    },
      -                    "days": {
      -                      "description": "Distinct event dates among them.",
      -                      "type": "integer"
      -                    },
      -                    "last_date": {
      -                      "description": "The newest checked event date (YYYY-MM-DD, monthly YYYY-MM): a Kalshi count stops at 10/29 (no Kalshi request since, CONTRACTS §33).",
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    },
      -                    "match": {
      -                      "description": "Matches; null until the product has the claim minimum of checked events.",
      -                      "type": [
      -                        "integer",
      -                        "null"
      -                      ]
      -                    },
      -                    "scope": {
      -                      "const": "venue+product+rule_from",
      -                      "description": "What the count pools: every city of the row's venue, product and rule version, not this city alone."
      -                    }
      -                  },
      -                  "required": [
      -                    "checked",
      -                    "days",
      -                    "scope"
      -                  ],
      -                  "type": "object"
      -                },
      -                {
      -                  "type": "null"
      -                }
      -              ],
      -              "description": "agree_30d split by venue, with its dates; null while nothing is checked."
      -            },
      -            "at": {
      -              "description": "UTC time of the report that set so_far (ISO).",
      -              "type": [
      -                "string",
      -                "null"
      -              ]
      -            },
      -            "bound": {
      -              "description": "What the result can still be given so far: >=61, <=44, >=1.42.",
      -              "type": [
      -                "string",
      -                "null"
      -              ]
      -            },
      -            "date": {
      -              "description": "The venue's date for this market: YYYY-MM-DD, YYYY-MM (monthly) or YYYY.",
      -              "type": "string"
      -            },
      -            "derived": {
      -              "description": "1 when the rule names a source we do not fetch and we compute the same number from the open source it shows.",
      -              "enum": [
      -                0,
      -                1,
      -                null
      -              ]
      -            },
      -            "event": {
      -              "description": "Venue event id (Kalshi event ticker, Polymarket event slug).",
      -              "type": [
      -                "string",
      -                "null"
      -              ]
      -            },
      -            "event_url": {
      -              "description": "The event page (Kalshi: the series page).",
      -              "type": [
      -                "string",
      -                "null"
      -              ]
      -            },
      -            "fam": {
      -              "description": "Market family.",
      -              "enum": [
      -                "high",
      -                "low",
      -                "rain"
      -              ]
      -            },
      -            "fc": {
      -              "description": "Forecast at the settlement station: daily max/min (fc_kind daily_extreme), or the chance in % (pop).",
      -              "type": [
      -                "number",
      -                "null"
      -              ]
      -            },
      -            "fc_alt": {
      -              "description": "Shadow. (fc_window, else fc) + fc_bias: a candidate forecast, not yet the served fc; null when neither applies.",
      -              "type": [
      -                "number",
      -                "null"
      -              ]
      -            },
      -            "fc_alt_by": {
      -              "description": "What fc_alt applied to fc.",
      -              "enum": [
      -                "window",
      -                "bias",
      -                "window+bias",
      -                null
      -              ]
      -            },
      -            "fc_bias": {
      -              "description": "Shadow. The correction added for fc_alt: minus the station's median error at this lead (1-3 days) and season, from the settled history, shrunk toward all stations; null without enough cases.",
      -              "type": [
      -                "number",
      -                "null"
      -              ]
      -            },
      -            "fc_by": {
      -              "description": "Where fc comes from: nbm = the station's NBM (NOAA National Blend of Models; Kalshi CLI days after today), blend = the median.",
      -              "enum": [
      -                "nbm",
      -                "blend",
      -                null
      -              ]
      -            },
      -            "fc_issued_at": {
      -              "description": "high/low: the oldest run in fc_runs (UTC): the age of the oldest input behind fc. Null for rain and without a forecast (CONTRACTS §51).",
      -              "type": [
      -                "string",
      -                "null"
      -              ]
      -            },
      -            "fc_kind": {
      -              "description": "What fc is.",
      -              "enum": [
      -                "daily_extreme",
      -                "pop",
      -                "rest_of_month",
      -                null
      -              ]
      -            },
      -            "fc_left_h": {
      -              "description": "Rain: hours left in the climate day (rain.enabled); else null.",
      -              "type": [
      -                "number",
      -                "null"
      -              ]
      -            },
      -            "fc_n": {
      -              "description": "Forecasts (or model families) behind fc.",
      -              "type": [
      -                "integer",
      -                "null"
      -              ]
      -            },
      -            "fc_raw": {
      -              "description": "Temperature rows: fc as served (shadow fields below leave it unchanged); null on rain rows.",
      -              "type": [
      -                "number",
      -                "null"
      -              ]
      -            },
      -            "fc_rest": {
      -              "description": "Monthly rain: expected rest of month (mean).",
      -              "type": [
      -                "number",
      -                "null"
      -              ]
      -            },
      -            "fc_rest_p10": {
      -              "description": "Rain: rest-of-month 10th percentile (rain.enabled); else null.",
      -              "type": [
      -                "number",
      -                "null"
      -              ]
      -            },
      -            "fc_rest_p90": {
      -              "description": "Rain: rest-of-month 90th percentile (rain.enabled); else null.",
      -              "type": [
      -                "number",
      -                "null"
      -              ]
      -            },
      -            "fc_rest_p_ge": {
      -              "anyOf": [
      -                {
      -                  "additionalProperties": {
      -                    "type": "integer"
      -                  },
      -                  "type": "object"
      -                },
      -                {
      -                  "type": "null"
      -                }
      -              ],
      -              "description": "Monthly rain (rain.enabled): {line: chance %} for each strike line of the event's bins (bin lower edges, in unit): the chance the month total reaches the line as the venue counts it (a rain ladder's 'Above X': more than X): the venue's count, moved by the station's hourly rain to each ensemble's start, + its rest (members, then the station's 1991-2020 history). Null when the bins, the distribution or that hourly rain are unknown, and while markets.publish_probs is off (CONTRACTS §58)."
      -            },
      -            "fc_rest_thru": {
      -              "description": "Non-US: the rest-of-month forecast stops at this date.",
      -              "type": [
      -                "string",
      -                "null"
      -              ]
      -            },
      -            "fc_runs": {
      -              "anyOf": [
      -                {
      -                  "items": {
      -                    "type": "string"
      -                  },
      -                  "type": "array"
      -                },
      -                {
      -                  "type": "null"
      -                }
      -              ],
      -              "description": "Runs behind fc. high/low: each input's run or issue time (UTC ISO), aligned with fc_src. Rain: the run hour per family (HHZ, rain.enabled). Null without a forecast."
      -            },
      -            "fc_src": {
      -              "anyOf": [
      -                {
      -                  "items": {
      -                    "type": "string"
      -                  },
      -                  "type": "array"
      -                },
      -                {
      -                  "type": "null"
      -                }
      -              ],
      -              "description": "Inputs behind fc. high/low: the source ids (/api/v1/sources) whose values made fc, one per input (fc_n of them for a day's median; [\"nbm\"] when fc_by is nbm). Rain: model families (rain.enabled). Null without a forecast (CONTRACTS §51)."
      -            },
      -            "fc_window": {
      -              "description": "Shadow. Kalshi days after today with fc_by nbm: the NBM day on the market's midnight-to-midnight standard-time day (NBM's own windows are 19-08 for the low and 07-19 for the high), checked with that NBM cycle's 3-hourly temperatures; equals fc when the added hours do not change it; null when not checked.",
      -              "type": [
      -                "number",
      -                "null"
      -              ]
      -            },
      -            "final_cli": {
      -              "description": "Kalshi CLI rows whose window is over (settling, settled): true once ours is the first final NWS CLI, false before; null otherwise.",
      -              "type": [
      -                "boolean",
      -                "null"
      -              ]
      -            },
      -            "flag": {
      -              "description": "low_after_midnight: the low may come after midnight (Kalshi day to 1 am); provisional (rain): pop is 100 from rain recorded in METARs or a preliminary CLI, not the final report.",
      -              "type": [
      -                "string",
      -                "null"
      -              ]
      -            },
      -            "kind": {
      -              "description": "Market kind.",
      -              "enum": [
      -                "day",
      -                "weekend",
      -                "month",
      -                "season",
      -                "once",
      -                "window",
      -                "year"
      -              ]
      -            },
      -            "mtd": {
      -              "description": "Monthly rain: month to date.",
      -              "type": [
      -                "number",
      -                "null"
      -              ]
      -            },
      -            "mtd_through": {
      -              "description": "Last day inside mtd (YYYY-MM-DD).",
      -              "type": [
      -                "string",
      -                "null"
      -              ]
      -            },
      -            "n_obs": {
      -              "description": "Reports counted so far.",
      -              "type": [
      -                "integer",
      -                "null"
      -              ]
      -            },
      -            "note": {
      -              "description": "State text (rule changed, late), else null.",
      -              "type": [
      -                "string",
      -                "null"
      -              ]
      -            },
      -            "ours": {
      -              "description": "Our reconstructed settle value once the window is done.",
      -              "type": [
      -                "number",
      -                "null"
      -              ]
      -            },
      -            "ours_src": {
      -              "description": "Where ours comes from.",
      -              "enum": [
      -                "group24",
      -                "cli_final",
      -                "cli_cor",
      -                "rule",
      -                null
      -              ]
      -            },
      -            "partial": {
      -              "description": "1 when an hour of the window has no routine report.",
      -              "enum": [
      -                0,
      -                1,
      -                null
      -              ]
      -            },
      -            "place": {
      -              "description": "Slug of the market city.",
      -              "type": "string"
      -            },
      -            "pop": {
      -              "description": "Rain markets: chance of 0.01 in or more, %.",
      -              "type": [
      -                "integer",
      -                "null"
      -              ]
      -            },
      -            "product": {
      -              "description": "Settlement product (CLI_T, METAR_R, HKO_T, CLI_P, ...; /llms-full.txt has the glossary).",
      -              "type": "string"
      -            },
      -            "result": {
      -              "description": "The venue's official result as text in the market unit (61, 60-61, Yes).",
      -              "type": [
      -                "string",
      -                "null"
      -              ]
      -            },
      -            "result_src": {
      -              "description": "Where `result` comes from, or why there is none.",
      -              "type": [
      -                "string",
      -                "null"
      -              ]
      -            },
      -            "result_tracked": {
      -              "description": "True when groundhog reads this venue's results now; false for Kalshi (no Kalshi request, CONTRACTS §33): result stays null after 10/29.",
      -              "type": [
      -                "boolean",
      -                "null"
      -              ]
      -            },
      -            "rule": {
      -              "description": "Our one-line paraphrase of the rule (never venue text).",
      -              "type": [
      -                "string",
      -                "null"
      -              ]
      -            },
      -            "so_far": {
      -              "description": "The value so far under the venue's own rule (temperature, or rain total).",
      -              "type": [
      -                "number",
      -                "null"
      -              ]
      -            },
      -            "src_url": {
      -              "description": "The settlement product we read (NWS CLI product, AWC METAR API URL, ...).",
      -              "type": [
      -                "string",
      -                "null"
      -              ]
      -            },
      -            "state": {
      -              "description": "Where the market stands; upcoming = its measuring window has not started (it may be trading: trading_open).",
      -              "enum": [
      -                "upcoming",
      -                "open",
      -                "settling",
      -                "proposed",
      -                "settled",
      -                "rule_changed",
      -                "late",
      -                "link_only",
      -                "no_data"
      -              ]
      -            },
      -            "stn": {
      -              "description": "Settlement station (ICAO or the source's station id).",
      -              "type": [
      -                "string",
      -                "null"
      -              ]
      -            },
      -            "trading_open": {
      -              "description": "Polymarket: true while the venue lists this event as open for trading (gamma: not closed), false once closed, proposed or settled; null without an event or while groundhog's Polymarket list is stale. Kalshi: null (no Kalshi request, CONTRACTS §33). Independent of state: a day-ahead market trades while its window is upcoming.",
      -              "type": [
      -                "boolean",
      -                "null"
      -              ]
      -            },
      -            "unit": {
      -              "description": "Unit of every value in this row (the venue's own).",
      -              "enum": [
      -                "F",
      -                "C",
      -                "in",
      -                "mm"
      -              ]
      -            },
      -            "url": {
      -              "description": "The market page (Kalshi series page, Polymarket event page).",
      -              "type": [
      -                "string",
      -                "null"
      -              ]
      -            },
      -            "venue": {
      -              "description": "Venue.",
      -              "enum": [
      -                "kalshi",
      -                "polymarket"
      -              ]
      -            },
      -            "win": {
      -              "description": "Rain: the window of fc (rain.enabled); else null.",
      -              "enum": [
      -                "lst",
      -                "cal",
      -                null
      -              ]
      -            },
      -            "win_end": {
      -              "description": "Window end (UTC ISO).",
      -              "type": [
      -                "string",
      -                "null"
      -              ]
      -            },
      -            "win_start": {
      -              "description": "Window start (UTC ISO); null for link-only rows.",
      -              "type": [
      -                "string",
      -                "null"
      -              ]
      -            },
      -            "window_starts_in_h": {
      -              "description": "Hours until the measuring window starts (0.1 h); null once it has started or without a window. state upcoming = this is ahead.",
      -              "type": [
      -                "number",
      -                "null"
      -              ]
      -            }
      -          },
      -          "required": [
      -            "place",
      -            "venue",
      -            "fam",
      -            "kind",
      -            "date",
      -            "product",
      -            "unit",
      -            "state"
      -          ],
      -          "type": "object"
      -        },
      -        "type": "array"
      -      },
      -      "size": {
      -        "description": "line (per place) | table.",
      -        "enum": [
      -          "line",
      -          "table"
      -        ]
      -      },
      -      "url": {
      -        "description": "The page that shows this answer (the place page, else /markets).",
      -        "type": "string"
      -      },
      -      "v": {
      -        "const": 1,
      -        "description": "Body version."
      -      }
      -    },
      -    "required": [
      -      "v",
      -      "kind",
      -      "size",
      -      "asof",
      -      "family",
      -      "date",
      -      "places",
      -      "url",
      -      "rows",
      -      "notes",
      -      "credits",
      -      "credit_keys",
      -      "credits_url"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "description": "markets() with none of place, family and venue: every market city.",
      -    "properties": {
      -      "kind": {
      -        "const": "market_cities",
      -        "description": "Body kind."
      -      },
      -      "n": {
      -        "description": "Cities.",
      -        "type": "integer"
      -      },
      -      "notes": {
      -        "description": "Ends with \"No prices.\".",
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "places": {
      -        "description": "Every market city, by slug.",
      -        "items": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "display": {
      -              "description": "Display name.",
      -              "type": [
      -                "string",
      -                "null"
      -              ]
      -            },
      -            "families": {
      -              "description": "Market families of the city.",
      -              "items": {
      -                "enum": [
      -                  "high",
      -                  "low",
      -                  "rain"
      -                ]
      -              },
      -              "type": "array"
      -            },
      -            "slug": {
      -              "description": "Pass as markets place.",
      -              "type": "string"
      -            },
      -            "venues": {
      -              "description": "Venues listing them.",
      -              "items": {
      -                "enum": [
      -                  "kalshi",
      -                  "polymarket"
      -                ]
      -              },
      -              "type": "array"
      -            }
      -          },
      -          "required": [
      -            "slug",
      -            "families",
      -            "venues"
      -          ],
      -          "type": "object"
      -        },
      -        "type": "array"
      -      },
      -      "v": {
      -        "const": 1,
      -        "description": "Body version."
      -      }
      -    },
      -    "required": [
      -      "v",
      -      "kind",
      -      "n",
      -      "places",
      -      "notes"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "asof": {
      +        "description": "Request time (UTC).",
      +        "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}Z$",
      +        "type": "string"
      +      },
      +      "build": {
      +        "description": "The running commit, 7 hex (dev off Tokay). With method, ties this body's numbers to the code and rules that made them (CONTRACTS §51).",
      +        "type": "string"
      +      },
      +      "credit_keys": {
      +        "description": "Their keys (/credits lists every line).",
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "credits": {
      +        "description": "Credit strings to keep when you repeat numbers.",
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "credits_url": {
      +        "description": "The full credits page.",
      +        "type": "string"
      +      },
      +      "date": {
      +        "description": "today | tomorrow | yesterday | YYYY-MM-DD, each place's local date. Default today: the market's own day at any hour (no 15:00 roll to tomorrow as /blend has); ask tomorrow for the next day's markets.",
      +        "type": "string"
      +      },
      +      "family": {
      +        "description": "Family asked for.",
      +        "enum": [
      +          "high",
      +          "low",
      +          "rain",
      +          "all"
      +        ]
      +      },
      +      "kind": {
      +        "const": "markets",
      +        "description": "Body kind."
      +      },
      +      "method": {
      +        "description": "Method id: the contract rules that made this body's numbers (blend-median-v1, rain-month-v5, markets-nbm-led-v4, receipts-qa-v1, history-as-issued-v3, status-readiness-v1). A rule change gives a new id, so equal ids mean the same method (CONTRACTS §51).",
      +        "type": "string"
      +      },
      +      "notes": {
      +        "description": "Sentences about this answer; always ends with \"No prices.\".",
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "places": {
      +        "description": "The places answered (the index: every market city with a row).",
      +        "items": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "date": {
      +              "description": "Its local date for `date`.",
      +              "type": "string"
      +            },
      +            "display": {
      +              "description": "Display name.",
      +              "type": "string"
      +            },
      +            "n_rows": {
      +              "description": "Its rows in this body.",
      +              "type": "integer"
      +            },
      +            "slug": {
      +              "description": "Place slug (a lat,lon for a point).",
      +              "type": "string"
      +            },
      +            "url": {
      +              "description": "Its page.",
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "when": {
      +              "description": "today | tomorrow | yesterday | +N | past.",
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "slug",
      +            "display",
      +            "date",
      +            "when",
      +            "n_rows"
      +          ],
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "rows": {
      +        "description": "One row per venue x family x kind.",
      +        "items": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "agree": {
      +              "description": "Ours vs the venue's result for this event.",
      +              "enum": [
      +                "match",
      +                "differs",
      +                null
      +              ]
      +            },
      +            "agree_30d": {
      +              "description": "m/n matches over 30 days once the product passes the claim gate; else null. Pools both venues and every city of the row's product and rule version; agree_30d_detail is the row's own venue, with dates.",
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "agree_30d_detail": {
      +              "anyOf": [
      +                {
      +                  "additionalProperties": false,
      +                  "properties": {
      +                    "checked": {
      +                      "description": "Events checked (match or differs) for this venue, product and rule version, every city.",
      +                      "type": "integer"
      +                    },
      +                    "days": {
      +                      "description": "Distinct event dates among them.",
      +                      "type": "integer"
      +                    },
      +                    "last_date": {
      +                      "description": "The newest checked event date (YYYY-MM-DD, monthly YYYY-MM): a Kalshi count stops at 10/29 (no Kalshi request since, CONTRACTS §33).",
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "match": {
      +                      "description": "Matches; null until the product has the claim minimum of checked events.",
      +                      "type": [
      +                        "integer",
      +                        "null"
      +                      ]
      +                    },
      +                    "scope": {
      +                      "const": "venue+product+rule_from",
      +                      "description": "What the count pools: every city of the row's venue, product and rule version, not this city alone."
      +                    }
      +                  },
      +                  "required": [
      +                    "checked",
      +                    "days",
      +                    "scope"
      +                  ],
      +                  "type": "object"
      +                },
      +                {
      +                  "type": "null"
      +                }
      +              ],
      +              "description": "agree_30d split by venue, with its dates; null while nothing is checked."
      +            },
      +            "at": {
      +              "description": "UTC time of the report that set so_far (ISO).",
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "bound": {
      +              "description": "What the result can still be given so far: >=61, <=44, >=1.42.",
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "date": {
      +              "description": "The venue's date for this market: YYYY-MM-DD, YYYY-MM (monthly) or YYYY.",
      +              "type": "string"
      +            },
      +            "derived": {
      +              "description": "1 when the rule names a source we do not fetch and we compute the same number from the open source it shows.",
      +              "enum": [
      +                0,
      +                1,
      +                null
      +              ]
      +            },
      +            "event": {
      +              "description": "Venue event id (Kalshi event ticker, Polymarket event slug).",
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "event_url": {
      +              "description": "The event page (Kalshi: the series page).",
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "fam": {
      +              "description": "Market family.",
      +              "enum": [
      +                "high",
      +                "low",
      +                "rain"
      +              ]
      +            },
      +            "fc": {
      +              "description": "Forecast at the settlement station: daily max/min (fc_kind daily_extreme), or the chance in % (pop). The headline, the number to use (CONTRACTS §29; fc_by says where it comes from, method names the rule); the shadow fields are candidates, not the headline.",
      +              "type": [
      +                "number",
      +                "null"
      +              ]
      +            },
      +            "fc_alt": {
      +              "description": "Shadow. (fc_window, else fc) + fc_bias: a candidate forecast, not yet the served fc; null when neither applies. Archived as served and scored against settle values (CONTRACTS §56, §58).",
      +              "type": [
      +                "number",
      +                "null"
      +              ]
      +            },
      +            "fc_alt_by": {
      +              "description": "What fc_alt applied to fc.",
      +              "enum": [
      +                "window",
      +                "bias",
      +                "window+bias",
      +                null
      +              ]
      +            },
      +            "fc_bias": {
      +              "description": "Shadow. The correction added for fc_alt: minus the station's median error at this lead (1-3 days) and season, from the settled history, shrunk toward all stations; null without enough cases.",
      +              "type": [
      +                "number",
      +                "null"
      +              ]
      +            },
      +            "fc_by": {
      +              "description": "Where fc comes from: nbm = the station's NBM (NOAA National Blend of Models; Kalshi CLI days after today), blend = the median.",
      +              "enum": [
      +                "nbm",
      +                "blend",
      +                null
      +              ]
      +            },
      +            "fc_issued_at": {
      +              "description": "high/low: the oldest run in fc_runs (UTC): the age of the oldest input behind fc. Null for rain and without a forecast (CONTRACTS §51).",
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "fc_kind": {
      +              "description": "What fc is.",
      +              "enum": [
      +                "daily_extreme",
      +                "pop",
      +                "rest_of_month",
      +                null
      +              ]
      +            },
      +            "fc_left_h": {
      +              "description": "Rain: hours left in the climate day (rain.enabled); else null.",
      +              "type": [
      +                "number",
      +                "null"
      +              ]
      +            },
      +            "fc_n": {
      +              "description": "Forecasts (or model families) behind fc.",
      +              "type": [
      +                "integer",
      +                "null"
      +              ]
      +            },
      +            "fc_raw": {
      +              "description": "Temperature rows: fc as served (shadow fields below leave it unchanged); null on rain rows.",
      +              "type": [
      +                "number",
      +                "null"
      +              ]
      +            },
      +            "fc_rest": {
      +              "description": "Monthly rain: expected rest of month (mean).",
      +              "type": [
      +                "number",
      +                "null"
      +              ]
      +            },
      +            "fc_rest_p10": {
      +              "description": "Rain: rest-of-month 10th percentile (rain.enabled); else null.",
      +              "type": [
      +                "number",
      +                "null"
      +              ]
      +            },
      +            "fc_rest_p90": {
      +              "description": "Rain: rest-of-month 90th percentile (rain.enabled); else null.",
      +              "type": [
      +                "number",
      +                "null"
      +              ]
      +            },
      +            "fc_rest_p_ge": {
      +              "anyOf": [
      +                {
      +                  "additionalProperties": {
      +                    "type": "integer"
      +                  },
      +                  "type": "object"
      +                },
      +                {
      +                  "type": "null"
      +                }
      +              ],
      +              "description": "Monthly rain (rain.enabled): {line: chance %} for each strike line of the event's bins (bin lower edges, in unit): the chance the month total reaches the line as the venue counts it (a rain ladder's 'Above X': more than X): the venue's count, moved by the station's hourly rain to each ensemble's start, + its rest (members, then the station's 1991-2020 history). Null when the bins, the distribution or that hourly rain are unknown, and while markets.publish_probs is off (CONTRACTS §58)."
      +            },
      +            "fc_rest_thru": {
      +              "description": "Non-US: the rest-of-month forecast stops at this date.",
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "fc_runs": {
      +              "anyOf": [
      +                {
      +                  "items": {
      +                    "type": "string"
      +                  },
      +                  "type": "array"
      +                },
      +                {
      +                  "type": "null"
      +                }
      +              ],
      +              "description": "Runs behind fc. high/low: each input's run or issue time (UTC ISO), aligned with fc_src. Rain: the run hour per family (HHZ, rain.enabled). Null without a forecast."
      +            },
      +            "fc_src": {
      +              "anyOf": [
      +                {
      +                  "items": {
      +                    "type": "string"
      +                  },
      +                  "type": "array"
      +                },
      +                {
      +                  "type": "null"
      +                }
      +              ],
      +              "description": "Inputs behind fc. high/low: the source ids (/api/v1/sources) whose values made fc, one per input (fc_n of them for a day's median; [\"nbm\"] when fc_by is nbm). Rain: model families (rain.enabled). Null without a forecast (CONTRACTS §51)."
      +            },
      +            "fc_window": {
      +              "description": "Shadow. Kalshi days after today with fc_by nbm: the NBM day on the market's midnight-to-midnight standard-time day (NBM's own windows are 19-08 for the low and 07-19 for the high), checked with that NBM cycle's 3-hourly temperatures; equals fc when the added hours do not change it; null when not checked.",
      +              "type": [
      +                "number",
      +                "null"
      +              ]
      +            },
      +            "final_cli": {
      +              "description": "Kalshi CLI rows whose window is over (settling, settled): true once ours is the first final NWS CLI, false before; null otherwise.",
      +              "type": [
      +                "boolean",
      +                "null"
      +              ]
      +            },
      +            "flag": {
      +              "description": "low_after_midnight: the low may come after midnight (Kalshi day to 1 am); provisional (rain): pop is 100 from rain recorded in METARs or a preliminary CLI, not the final report.",
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "kind": {
      +              "description": "Market kind.",
      +              "enum": [
      +                "day",
      +                "weekend",
      +                "month",
      +                "season",
      +                "once",
      +                "window",
      +                "year"
      +              ]
      +            },
      +            "market": {
      +              "description": "Kalshi: the market ticker of this city's market in a multi-city series (KXRAINWKND-26NOV14-CHI, KXRAIN-26NOV11-CHI), which `event` serves without the city code: the id Kalshi's own feeds use for this row. Null for a ladder event (one market per bin or line: join on event and the strike), for Polymarket (market ids not ingested: join on the event slug and the bin label) and without an event (CONTRACTS §60).",
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "mtd": {
      +              "description": "Monthly rain: month to date.",
      +              "type": [
      +                "number",
      +                "null"
      +              ]
      +            },
      +            "mtd_through": {
      +              "description": "Last day inside mtd (YYYY-MM-DD).",
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "n_obs": {
      +              "description": "Reports counted so far.",
      +              "type": [
      +                "integer",
      +                "null"
      +              ]
      +            },
      +            "note": {
      +              "description": "State text (rule changed, late), else null.",
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "ours": {
      +              "description": "Our reconstructed settle value once the window is done.",
      +              "type": [
      +                "number",
      +                "null"
      +              ]
      +            },
      +            "ours_src": {
      +              "description": "Where ours comes from.",
      +              "enum": [
      +                "group24",
      +                "cli_final",
      +                "cli_cor",
      +                "rule",
      +                null
      +              ]
      +            },
      +            "partial": {
      +              "description": "1 when an hour of the window has no routine report.",
      +              "enum": [
      +                0,
      +                1,
      +                null
      +              ]
      +            },
      +            "place": {
      +              "description": "Slug of the market city.",
      +              "type": "string"
      +            },
      +            "pop": {
      +              "description": "Rain markets: chance of 0.01 in or more, %.",
      +              "type": [
      +                "integer",
      +                "null"
      +              ]
      +            },
      +            "product": {
      +              "description": "Settlement product (CLI_T, METAR_R, HKO_T, CLI_P, ...; /llms-full.txt has the glossary).",
      +              "type": "string"
      +            },
      +            "result": {
      +              "description": "The venue's official result as text in the market unit (61, 60-61, Yes).",
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "result_src": {
      +              "description": "Where `result` comes from, or why there is none.",
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "result_tracked": {
      +              "description": "True when groundhog reads this venue's results now; false for Kalshi (no Kalshi request, CONTRACTS §33): result stays null after 10/29.",
      +              "type": [
      +                "boolean",
      +                "null"
      +              ]
      +            },
      +            "rule": {
      +              "description": "Our one-line paraphrase of the rule (never venue text).",
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "series_key": {
      +              "description": "groundhog's series key: the Kalshi series ticker, with the city's market code for a multi-city series (KXRAINWKND-CHI), or the Polymarket slug pattern; the key /api/v1/markets/coverage lists (CONTRACTS §60).",
      +              "type": "string"
      +            },
      +            "so_far": {
      +              "description": "The value so far under the venue's own rule (temperature, or rain total).",
      +              "type": [
      +                "number",
      +                "null"
      +              ]
      +            },
      +            "src_url": {
      +              "description": "The settlement product we read (NWS CLI product, AWC METAR API URL, ...).",
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "state": {
      +              "description": "Where the market stands; upcoming = its measuring window has not started (it may be trading: trading_open).",
      +              "enum": [
      +                "upcoming",
      +                "open",
      +                "settling",
      +                "proposed",
      +                "settled",
      +                "rule_changed",
      +                "late",
      +                "link_only",
      +                "no_data"
      +              ]
      +            },
      +            "stn": {
      +              "description": "Settlement station (ICAO or the source's station id).",
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "trading_open": {
      +              "description": "Polymarket: true while the venue lists this event as open for trading (gamma: not closed), false once closed, proposed or settled; null without an event or while groundhog's Polymarket list is stale. Kalshi: null (no Kalshi request, CONTRACTS §33). Independent of state: a day-ahead market trades while its window is upcoming.",
      +              "type": [
      +                "boolean",
      +                "null"
      +              ]
      +            },
      +            "unit": {
      +              "description": "Unit of every value in this row (the venue's own).",
      +              "enum": [
      +                "F",
      +                "C",
      +                "in",
      +                "mm"
      +              ]
      +            },
      +            "url": {
      +              "description": "The market page (Kalshi series page, Polymarket event page).",
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "venue": {
      +              "description": "Venue.",
      +              "enum": [
      +                "kalshi",
      +                "polymarket"
      +              ]
      +            },
      +            "win": {
      +              "description": "Rain: the window of fc (rain.enabled); else null.",
      +              "enum": [
      +                "lst",
      +                "cal",
      +                null
      +              ]
      +            },
      +            "win_end": {
      +              "description": "Window end (UTC ISO).",
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "win_start": {
      +              "description": "Window start (UTC ISO); null for link-only rows.",
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "window_starts_in_h": {
      +              "description": "Hours until the measuring window starts (0.1 h); null once it has started or without a window. state upcoming = this is ahead.",
      +              "type": [
      +                "number",
      +                "null"
      +              ]
      +            }
      +          },
      +          "required": [
      +            "place",
      +            "venue",
      +            "fam",
      +            "kind",
      +            "date",
      +            "product",
      +            "unit",
      +            "state"
      +          ],
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "size": {
      +        "description": "line (per place) | table.",
      +        "enum": [
      +          "line",
      +          "table"
      +        ]
      +      },
      +      "url": {
      +        "description": "The page that shows this answer (the place page, else /markets).",
      +        "type": "string"
      +      },
      +      "v": {
      +        "const": 1,
      +        "description": "Body version."
      +      }
      +    },
      +    "required": [
      +      "v",
      +      "kind",
      +      "size",
      +      "asof",
      +      "family",
      +      "date",
      +      "places",
      +      "url",
      +      "rows",
      +      "notes",
      +      "credits",
      +      "credit_keys",
      +      "credits_url"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "description": "markets() with none of place, family and venue: every market city.",
      +    "properties": {
      +      "kind": {
      +        "const": "market_cities",
      +        "description": "Body kind."
      +      },
      +      "n": {
      +        "description": "Cities.",
      +        "type": "integer"
      +      },
      +      "notes": {
      +        "description": "Ends with \"No prices.\".",
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "places": {
      +        "description": "Every market city, by slug.",
      +        "items": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "display": {
      +              "description": "Display name.",
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "families": {
      +              "description": "Market families of the city.",
      +              "items": {
      +                "enum": [
      +                  "high",
      +                  "low",
      +                  "rain"
      +                ]
      +              },
      +              "type": "array"
      +            },
      +            "slug": {
      +              "description": "Pass as markets place.",
      +              "type": "string"
      +            },
      +            "venues": {
      +              "description": "Venues listing them.",
      +              "items": {
      +                "enum": [
      +                  "kalshi",
      +                  "polymarket"
      +                ]
      +              },
      +              "type": "array"
      +            }
      +          },
      +          "required": [
      +            "slug",
      +            "families",
      +            "venues"
      +          ],
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "v": {
      +        "const": 1,
      +        "description": "Body version."
      +      }
      +    },
      +    "required": [
      +      "v",
      +      "kind",
      +      "n",
      +      "places",
      +      "notes"
      +    ],
      +    "type": "object"
      +  }
      +]
  3. Changed2 schema fields changed
    • addedInput schema / properties / fields
      Added value: +{
      +  "description": "full (default) | compact: leave out null members of the JSON (structuredContent and format=json)",
      +  "enum": [
      +    "full",
      +    "compact"
      +  ],
      +  "type": "string"
      +}
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "anyOf": [
      +    {
      +      "additionalProperties": false,
      +      "properties": {
      +        "asof": {
      +          "description": "Request time (UTC).",
      +          "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}Z$",
      +          "type": "string"
      +        },
      +        "build": {
      +          "description": "The running commit, 7 hex (dev off Tokay). With method, ties this body's numbers to the code and rules that made them (CONTRACTS §51).",
      +          "type": "string"
      +        },
      +        "credit_keys": {
      +          "description": "Their keys (/credits lists every line).",
      +          "items": {
      +            "type": "string"
      +          },
      +          "type": "array"
      +        },
      +        "credits": {
      +          "description": "Credit strings to keep when you repeat numbers.",
      +          "items": {
      +            "type": "string"
      +          },
      +          "type": "array"
      +        },
      +        "credits_url": {
      +          "description": "The full credits page.",
      +          "type": "string"
      +        },
      +        "date": {
      +          "description": "today | tomorrow | yesterday | YYYY-MM-DD, each place's local date. Default today: the market's own day at any hour (no 15:00 roll to tomorrow as /blend has); ask tomorrow for the next day's markets.",
      +          "type": "string"
      +        },
      +        "family": {
      +          "description": "Family asked for.",
      +          "enum": [
      +            "high",
      +            "low",
      +            "rain",
      +            "all"
      +          ]
      +        },
      +        "kind": {
      +          "const": "markets",
      +          "description": "Body kind."
      +        },
      +        "method": {
      +          "description": "Method id: the contract rules that made this body's numbers (blend-median-v1, rain-month-v3, markets-nbm-led-v2, receipts-qa-v1, history-as-issued-v3, status-readiness-v1). A rule change gives a new id, so equal ids mean the same method (CONTRACTS §51).",
      +          "type": "string"
      +        },
      +        "notes": {
      +          "description": "Sentences about this answer; always ends with \"No prices.\".",
      +          "items": {
      +            "type": "string"
      +          },
      +          "type": "array"
      +        },
      +        "places": {
      +          "description": "The places answered (the index: every market city with a row).",
      +          "items": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "date": {
      +                "description": "Its local date for `date`.",
      +                "type": "string"
      +              },
      +              "display": {
      +                "description": "Display name.",
      +                "type": "string"
      +              },
      +              "n_rows": {
      +                "description": "Its rows in this body.",
      +                "type": "integer"
      +              },
      +              "slug": {
      +                "description": "Place slug (a lat,lon for a point).",
      +                "type": "string"
      +              },
      +              "url": {
      +                "description": "Its page.",
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "when": {
      +                "description": "today | tomorrow | yesterday | +N | past.",
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "slug",
      +              "display",
      +              "date",
      +              "when",
      +              "n_rows"
      +            ],
      +            "type": "object"
      +          },
      +          "type": "array"
      +        },
      +        "rows": {
      +          "description": "One row per venue x family x kind.",
      +          "items": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "agree": {
      +                "description": "Ours vs the venue's result for this event.",
      +                "enum": [
      +                  "match",
      +                  "differs",
      +                  null
      +                ]
      +              },
      +              "agree_30d": {
      +                "description": "m/n matches over 30 days once the product passes the claim gate; else null.",
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "agree_30d_detail": {
      +                "anyOf": [
      +                  {
      +                    "additionalProperties": false,
      +                    "properties": {
      +                      "checked": {
      +                        "description": "Events checked (match or differs) for this venue, product and rule version, every city.",
      +                        "type": "integer"
      +                      },
      +                      "days": {
      +                        "description": "Distinct event dates among them.",
      +                        "type": "integer"
      +                      },
      +                      "last_date": {
      +                        "description": "The newest checked event date (YYYY-MM-DD, monthly YYYY-MM): a Kalshi count stops at 10/29 (no Kalshi request since, CONTRACTS §33).",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "match": {
      +                        "description": "Matches; null until the product has the claim minimum of checked events.",
      +                        "type": [
      +                          "integer",
      +                          "null"
      +                        ]
      +                      },
      +                      "scope": {
      +                        "const": "venue+product+rule_from",
      +                        "description": "What the count pools: every city of the row's venue, product and rule version, not this city alone."
      +                      }
      +                    },
      +                    "required": [
      +                      "checked",
      +                      "days",
      +                      "scope"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ],
      +                "description": "agree_30d split by venue, with its dates; null while nothing is checked."
      +              },
      +              "at": {
      +                "description": "UTC time of the report that set so_far (ISO).",
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "bound": {
      +                "description": "What the result can still be given so far: >=61, <=44, >=1.42.",
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "date": {
      +                "description": "The venue's date for this market: YYYY-MM-DD, YYYY-MM (monthly) or YYYY.",
      +                "type": "string"
      +              },
      +              "derived": {
      +                "description": "1 when the rule names a source we do not fetch and we compute the same number from the open source it shows.",
      +                "enum": [
      +                  0,
      +                  1,
      +                  null
      +                ]
      +              },
      +              "event": {
      +                "description": "Venue event id (Kalshi event ticker, Polymarket event slug).",
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "event_url": {
      +                "description": "The event page (Kalshi: the series page).",
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "fam": {
      +                "description": "Market family.",
      +                "enum": [
      +                  "high",
      +                  "low",
      +                  "rain"
      +                ]
      +              },
      +              "fc": {
      +                "description": "Forecast at the settlement station: daily max/min (fc_kind daily_extreme), or the chance in % (pop).",
      +                "type": [
      +                  "number",
      +                  "null"
      +                ]
      +              },
      +              "fc_alt": {
      +                "description": "Shadow. (fc_window, else fc) + fc_bias: a candidate forecast, not yet the served fc; null when neither applies.",
      +                "type": [
      +                  "number",
      +                  "null"
      +                ]
      +              },
      +              "fc_alt_by": {
      +                "description": "What fc_alt applied to fc.",
      +                "enum": [
      +                  "window",
      +                  "bias",
      +                  "window+bias",
      +                  null
      +                ]
      +              },
      +              "fc_bias": {
      +                "description": "Shadow. The correction added for fc_alt: minus the station's median error at this lead (1-3 days) and season, from the settled history, shrunk toward all stations; null without enough cases.",
      +                "type": [
      +                  "number",
      +                  "null"
      +                ]
      +              },
      +              "fc_by": {
      +                "description": "Where fc comes from: nbm = the station's NBM (NOAA National Blend of Models; Kalshi CLI days after today), blend = the median.",
      +                "enum": [
      +                  "nbm",
      +                  "blend",
      +                  null
      +                ]
      +              },
      +              "fc_issued_at": {
      +                "description": "high/low: the oldest run in fc_runs (UTC): the age of the oldest input behind fc. Null for rain and without a forecast (CONTRACTS §51).",
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "fc_kind": {
      +                "description": "What fc is.",
      +                "enum": [
      +                  "daily_extreme",
      +                  "pop",
      +                  "rest_of_month",
      +                  null
      +                ]
      +              },
      +              "fc_left_h": {
      +                "description": "Rain: hours left in the climate day (rain.enabled); else null.",
      +                "type": [
      +                  "number",
      +                  "null"
      +                ]
      +              },
      +              "fc_n": {
      +                "description": "Forecasts (or model families) behind fc.",
      +                "type": [
      +                  "integer",
      +                  "null"
      +                ]
      +              },
      +              "fc_raw": {
      +                "description": "Temperature rows: fc as served (shadow fields below leave it unchanged); null on rain rows.",
      +                "type": [
      +                  "number",
      +                  "null"
      +                ]
      +              },
      +              "fc_rest": {
      +                "description": "Monthly rain: expected rest of month (mean).",
      +                "type": [
      +                  "number",
      +                  "null"
      +                ]
      +              },
      +              "fc_rest_p10": {
      +                "description": "Rain: rest-of-month 10th percentile (rain.enabled); else null.",
      +                "type": [
      +                  "number",
      +                  "null"
      +                ]
      +              },
      +              "fc_rest_p90": {
      +                "description": "Rain: rest-of-month 90th percentile (rain.enabled); else null.",
      +                "type": [
      +                  "number",
      +                  "null"
      +                ]
      +              },
      +              "fc_rest_p_ge": {
      +                "anyOf": [
      +                  {
      +                    "additionalProperties": {
      +                      "type": "integer"
      +                    },
      +                    "type": "object"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ],
      +                "description": "Monthly rain (rain.enabled): {line: chance %} for each strike line of the event's bins (bin lower edges, in unit): the chance the month total reaches the line as the venue counts it (a rain ladder's 'Above X': more than X): the venue's count, moved by the station's hourly rain to each ensemble's start, + its rest (members, then the station's 1991-2020 history). Null when the bins, the distribution or that hourly rain are unknown, and while markets.publish_probs is off (CONTRACTS §58)."
      +              },
      +              "fc_rest_thru": {
      +                "description": "Non-US: the rest-of-month forecast stops at this date.",
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "fc_runs": {
      +                "anyOf": [
      +                  {
      +                    "items": {
      +                      "type": "string"
      +                    },
      +                    "type": "array"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ],
      +                "description": "Runs behind fc. high/low: each input's run or issue time (UTC ISO), aligned with fc_src. Rain: the run hour per family (HHZ, rain.enabled). Null without a forecast."
      +              },
      +              "fc_src": {
      +                "anyOf": [
      +                  {
      +                    "items": {
      +                      "type": "string"
      +                    },
      +                    "type": "array"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ],
      +                "description": "Inputs behind fc. high/low: the source ids (/api/v1/sources) whose values made fc, one per input (fc_n of them for a day's median; [\"nbm\"] when fc_by is nbm). Rain: model families (rain.enabled). Null without a forecast (CONTRACTS §51)."
      +              },
      +              "fc_window": {
      +                "description": "Shadow. Kalshi days after today with fc_by nbm: the NBM day on the market's midnight-to-midnight standard-time day (NBM's own windows are 19-08 for the low and 07-19 for the high), checked with that NBM cycle's 3-hourly temperatures; equals fc when the added hours do not change it; null when not checked.",
      +                "type": [
      +                  "number",
      +                  "null"
      +                ]
      +              },
      +              "final_cli": {
      +                "description": "Kalshi CLI rows whose window is over (settling, settled): true once ours is the first final NWS CLI, false before; null otherwise.",
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "flag": {
      +                "description": "low_after_midnight: the low may come after midnight (Kalshi day to 1 am); provisional (rain): pop is 100 from rain recorded in METARs or a preliminary CLI, not the final report.",
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "kind": {
      +                "description": "Market kind.",
      +                "enum": [
      +                  "day",
      +                  "weekend",
      +                  "month",
      +                  "season",
      +                  "once",
      +                  "window",
      +                  "year"
      +                ]
      +              },
      +              "mtd": {
      +                "description": "Monthly rain: month to date.",
      +                "type": [
      +                  "number",
      +                  "null"
      +                ]
      +              },
      +              "mtd_through": {
      +                "description": "Last day inside mtd (YYYY-MM-DD).",
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "n_obs": {
      +                "description": "Reports counted so far.",
      +                "type": [
      +                  "integer",
      +                  "null"
      +                ]
      +              },
      +              "note": {
      +                "description": "State text (rule changed, late), else null.",
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "ours": {
      +                "description": "Our reconstructed settle value once the window is done.",
      +                "type": [
      +                  "number",
      +                  "null"
      +                ]
      +              },
      +              "ours_src": {
      +                "description": "Where ours comes from.",
      +                "enum": [
      +                  "group24",
      +                  "cli_final",
      +                  "cli_cor",
      +                  "rule",
      +                  null
      +                ]
      +              },
      +              "partial": {
      +                "description": "1 when an hour of the window has no routine report.",
      +                "enum": [
      +                  0,
      +                  1,
      +                  null
      +                ]
      +              },
      +              "place": {
      +                "description": "Slug of the market city.",
      +                "type": "string"
      +              },
      +              "pop": {
      +                "description": "Rain markets: chance of 0.01 in or more, %.",
      +                "type": [
      +                  "integer",
      +                  "null"
      +                ]
      +              },
      +              "product": {
      +                "description": "Settlement product (CLI_T, METAR_R, HKO_T, CLI_P, ...; /llms-full.txt has the glossary).",
      +                "type": "string"
      +              },
      +              "result": {
      +                "description": "The venue's official result as text in the market unit (61, 60-61, Yes).",
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "result_src": {
      +                "description": "Where `result` comes from, or why there is none.",
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "result_tracked": {
      +                "description": "True when groundhog reads this venue's results now; false for Kalshi (no Kalshi request, CONTRACTS §33): result stays null after 10/29.",
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "rule": {
      +                "description": "Our one-line paraphrase of the rule (never venue text).",
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "so_far": {
      +                "description": "The value so far under the venue's own rule (temperature, or rain total).",
      +                "type": [
      +                  "number",
      +                  "null"
      +                ]
      +              },
      +              "src_url": {
      +                "description": "The settlement product we read (NWS CLI product, AWC METAR API URL, ...).",
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "state": {
      +                "description": "Where the market stands; upcoming = its measuring window has not started (it may be trading: trading_open).",
      +                "enum": [
      +                  "upcoming",
      +                  "open",
      +                  "settling",
      +                  "proposed",
      +                  "settled",
      +                  "rule_changed",
      +                  "late",
      +                  "link_only",
      +                  "no_data"
      +                ]
      +              },
      +              "stn": {
      +                "description": "Settlement station (ICAO or the source's station id).",
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "trading_open": {
      +                "description": "Polymarket: true while the venue lists this event as open for trading (gamma: not closed), false once closed, proposed or settled; null without an event or while groundhog's Polymarket list is stale. Kalshi: null (no Kalshi request, CONTRACTS §33). Independent of state: a day-ahead market trades while its window is upcoming.",
      +                "type": [
      +                  "boolean",
      +                  "null"
      +                ]
      +              },
      +              "unit": {
      +                "description": "Unit of every value in this row (the venue's own).",
      +                "enum": [
      +                  "F",
      +                  "C",
      +                  "in",
      +                  "mm"
      +                ]
      +              },
      +              "url": {
      +                "description": "The market page (Kalshi series page, Polymarket event page).",
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "venue": {
      +                "description": "Venue.",
      +                "enum": [
      +                  "kalshi",
      +                  "polymarket"
      +                ]
      +              },
      +              "win": {
      +                "description": "Rain: the window of fc (rain.enabled); else null.",
      +                "enum": [
      +                  "lst",
      +                  "cal",
      +                  null
      +                ]
      +              },
      +              "win_end": {
      +                "description": "Window end (UTC ISO).",
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "win_start": {
      +                "description": "Window start (UTC ISO); null for link-only rows.",
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "window_starts_in_h": {
      +                "description": "Hours until the measuring window starts (0.1 h); null once it has started or without a window. state upcoming = this is ahead.",
      +                "type": [
      +                  "number",
      +                  "null"
      +                ]
      +              }
      +            },
      +            "required": [
      +              "place",
      +              "venue",
      +              "fam",
      +              "kind",
      +              "date",
      +              "product",
      +              "unit",
      +              "state"
      +            ],
      +            "type": "object"
      +          },
      +          "type": "array"
      +        },
      +        "size": {
      +          "description": "line (per place) | table.",
      +          "enum": [
      +            "line",
      +            "table"
      +          ]
      +        },
      +        "url": {
      +          "description": "The page that shows this answer (the place page, else /markets).",
      +          "type": "string"
      +        },
      +        "v": {
      +          "const": 1,
      +          "description": "Body version."
      +        }
      +      },
      +      "required": [
      +        "v",
      +        "kind",
      +        "size",
      +        "asof",
      +        "family",
      +        "date",
      +        "places",
      +        "url",
      +        "rows",
      +        "notes",
      +        "credits",
      +        "credit_keys",
      +        "credits_url"
      +      ],
      +      "type": "object"
      +    },
      +    {
      +      "additionalProperties": false,
      +      "description": "markets() with none of place, family and venue: every market city.",
      +      "properties": {
      +        "kind": {
      +          "const": "market_cities",
      +          "description": "Body kind."
      +        },
      +        "n": {
      +          "description": "Cities.",
      +          "type": "integer"
      +        },
      +        "notes": {
      +          "description": "Ends with \"No prices.\".",
      +          "items": {
      +            "type": "string"
      +          },
      +          "type": "array"
      +        },
      +        "places": {
      +          "description": "Every market city, by slug.",
      +          "items": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "display": {
      +                "description": "Display name.",
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "families": {
      +                "description": "Market families of the city.",
      +                "items": {
      +                  "enum": [
      +                    "high",
      +                    "low",
      +                    "rain"
      +                  ]
      +                },
      +                "type": "array"
      +              },
      +              "slug": {
      +                "description": "Pass as markets place.",
      +                "type": "string"
      +              },
      +              "venues": {
      +                "description": "Venues listing them.",
      +                "items": {
      +                  "enum": [
      +                    "kalshi",
      +                    "polymarket"
      +                  ]
      +                },
      +                "type": "array"
      +              }
      +            },
      +            "required": [
      +              "slug",
      +              "families",
      +              "venues"
      +            ],
      +            "type": "object"
      +          },
      +          "type": "array"
      +        },
      +        "v": {
      +          "const": 1,
      +          "description": "Body version."
      +        }
      +      },
      +      "required": [
      +        "v",
      +        "kind",
      +        "n",
      +        "places",
      +        "notes"
      +      ],
      +      "type": "object"
      +    }
      +  ],
      +  "description": "The JSON body (/api/v1/schema.json); fields=compact drops null members.",
      +  "type": "object"
      +}
  4. Changed1 schema field changed
    • addedInput schema / properties / venue
      Added value: +{
      +  "description": "kalshi | polymarket (default both); alone: every market of that venue",
      +  "enum": [
      +    "kalshi",
      +    "polymarket"
      +  ],
      +  "type": "string"
      +}
  5. First observed

TDQS

A3.8/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnly, idempotent, non-destructive and closed-world, so the safety profile is covered. The description adds genuinely new behavioral context: prices are deliberately excluded and must be read from each row's event/event_url, and format=json additionally returns structuredContent. The approximate token costs (line ≈526, table ≈1,757, every city ≈36,291) are unusual and useful cost disclosure. It does not describe pagination or error behavior, keeping it below a 5.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The purpose and contents come first, followed by the price disclaimer, the required-parameter rule, and cost figures — a sensible front-loaded order with no filler sentences. The telegraphic style ('line ≈526 tok, table ≈1,757; every city ≈36,291') is compressed but readable. Slight repetition of schema-level facts (format=json, structuredContent) keeps it from a 5.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 9-parameter, zero-required, read-only tool with no output schema, the description covers what an agent needs: what a row contains, how to scope the query, what happens with no arguments, output format behavior, and a pointer to the full JSON Schema URL. The unexplained `credits` parameter and the absence of any note on row volume limits are the remaining gaps.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 89%, so the baseline is 3, and the description earns above that by explaining semantics the schema cannot: the requirement that at least one of place/family/venue be supplied, the meaning of supplying none (city list), and the relative cost of the size modes. It leaves the `credits` parameter entirely unexplained in both schema and description, which is the main gap.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description names the specific resource (Kalshi and Polymarket weather markets for high/low/rain in a place) and enumerates what each row contains: settlement station and rule, value so far, forecast max/min, our value, official result. That is far more than a restatement of the name. It stops short of a 5 because the phrasing is a dense noun-phrase list rather than a clean verb+resource statement, and it does not explicitly separate itself from the sibling `forecast` tool, which also deals with forecasts.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It gives concrete scoping rules: 'Needs place, family or venue' and 'With none: the list of market cities', which tells the agent exactly what the zero-argument call does. It also routes away from price data ('No prices: read them from the venue'). However, there is no explicit when-to-use-this-vs-alternatives guidance against siblings such as forecast, places, or history, so the agent must infer that this tool is for settlement/rule-level market data.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources