therminal-py 0.2.0

Python SDK for Therminal — Kalshi temperature prediction markets + NWS weather data

therminal-py

Python SDK for Therminal — Kalshi temperature prediction markets + NWS weather data.

Install

pip install therminal-py            # core (returns dicts)
pip install therminal-py[pandas]    # + DataFrame support
pip install therminal-py[cli]       # + CLI tool
pip install therminal-py[dev]       # everything (for development)

Quick Start

from therminal import TherminalClient

client = TherminalClient()

# Get candles as a Pandas DataFrame
df = client.candles(
    market="KXHIGHNY-26MAR20-T50",
    from_date="2026-03-01",
    interval=5,
    as_dataframe=True,
)

# Get NYC weather observations in metric units
obs = client.observations(station="NYC", units="metric", limit=10)

# Download a parquet file
client.download_parquet("observations", station="NYC", year=2024)

Documentation

Full API reference with interactive playground: docs.mostlyright.xyz