# therminal-py

Python SDK for [Therminal](https://api.mostlyright.xyz) — Kalshi temperature prediction markets + NWS weather data.

## Install

```bash
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

```python
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](https://docs.mostlyright.xyz)**
