---
title: "Get Weather Index Calibrations"
method: GET
path: "/live_data/weather/{city}/calibrations"
tags: ["live-data"]
---

# Get Weather Index Calibrations

`GET /live_data/weather/{city}/calibrations`

## Request

- Base URL: `https://external-api.kalshi.com/trade-api/v2`
- URL: `https://external-api.kalshi.com/trade-api/v2/live_data/weather/{city}/calibrations`
- Auth: none declared

Get a city's published weather-index configuration timeline: the launch configuration plus every weekly offset calibration and methodology update, ascending by effective time. Each record carries the station weights, station offsets (Celsius), and the city reference used to compute index values from the record's effective time until the next record — everything needed to reproduce published index values for minutes computed under that configuration version. Offsets are re-estimated weekly after each complete UTC week; weights never change through calibration. The timeline is append-only and complete: it is never trimmed.

## Path parameters

- `city` string, required

## Response `200`

Calibration timeline retrieved successfully

- GetWeatherIndexCalibrationsResponse
  - `city` string, required: Index city ID.
  - `units` string, required: Always `celsius` — offsets and the city reference are Celsius quantities from the index methodology (the published index value itself is Fahrenheit).
  - `calibrations` WeatherIndexCalibration[], required: Configuration records, ascending by effective time.
    - `config_version` string, required: Configuration version (e.g. `miami-temperature-v1.0-cal-20260831`). Index points report the version they were computed under in their `config_version` field.
    - `published_at_ms` integer: When the record was published, unix milliseconds UTC.
    - `effective_at_ms` integer, required: The record governs event minutes at or after this time (unix milliseconds UTC), until superseded by the next record.
    - `change_reason` string: Why the configuration changed.
    - `calibration_window_start_ms` integer: Start of the trailing observation window the offsets were estimated from. Absent on records not derived from a calibration window (the launch configuration).
    - `calibration_window_end_ms` integer: End of the calibration window (exclusive).
    - `city_reference_c` number, double, required: City reference B_c in Celsius: the weight-dot-offset sum over all configured member stations.
    - `stations` WeatherIndexCalibrationStation[], required: Configured member stations, in configuration order.
      - `station_id` string, required: Member station ID (e.g. `KMIA1M`).
      - `weight` number, double, required: Base weight (weights sum to 1.0 across members).
      - `offset_c` number, double, required: Station offset in Celsius (positive = station normally runs warmer than its peers).
      - `update_note` string: Weekly-calibration disposition, present only on weekly calibration records: `updated ...` with the residual count, target, and applied adjustment, or `insufficient ...` when the prior offset was retained.

## Other responses

- `400`: Unknown city
- `500`: Internal server error

## Changes

- **2026-08-31** `2093c418fb5d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/kalshi/apis/kalshi-trade-api-manual-endpoints/changes/live_data/weather/:city/calibrations/get.md)

---

[API](https://skmtc.dev/kalshi/apis/kalshi-trade-api-manual-endpoints.md) - [All operations](https://skmtc.dev/kalshi/apis/kalshi-trade-api-manual-endpoints/llms.txt) - [OpenAPI document](https://skmtc.dev/kalshi/apis/kalshi-trade-api-manual-endpoints/revisions/e6691cdd1915?raw)