# Mostly Right

> Mostly Right is a Python and TypeScript SDK for public data with clear sources and timestamps. Historical and live methods use the same parser and core fields. Every row names its source.

## Install

- Python 3.11+: `pip install mostlyrightmd`
- TypeScript / Node 20+: `pnpm add mostlyright`
- `MOSTLYRIGHT_API_KEY` is required to retrieve the current source manifest; it comes with the subscription (USD 29/month, https://app.mostlyright.md). Without it the SDK raises `ApiKeyRequiredError`.
- The manifest supplies current endpoint, schema, and source definitions. The SDK then fetches rows directly from each source.
- Local cache: Python `~/.mostlyright/cache/`; Node `~/.mostlyright/cache-ts/`; browser IndexedDB.

## Stable entry points

- Weather observations: Python and TypeScript `weather.observations(...)`
- Current weather: Python `await weather.live.latest(station)`; TypeScript `await weather.latest(station)`
- Daily summaries: Python `weather.daily_summaries(...)`; TypeScript `dailySummaries(...)` from `@mostlyrightmd/weather/daily-summaries`
- Economic history: Python `economy.series(...)`; TypeScript `series(...)` from `@mostlyrightmd/economy`
- Economic cutoff: Python `economy.snapshot(...)`; TypeScript `snapshot(...)` from `@mostlyrightmd/economy`
- Kalshi contract parsing: Python `kalshi.parse_ticker(...)`; TypeScript `parseTicker(...)`
- Market data: Python `markets.kalshi.*` and `markets.polymarket.*`; TypeScript camelCase verbs from `@mostlyrightmd/markets/market-data`
- Finance: transcript `resolve()` and `derive()`; TypeScript also provides hosted `get()` and live `stream()`

## Domains

- Weather: live METAR, archived observations, forecasts, daily summaries, citizen stations, and satellite measurements
- Markets: Kalshi and Polymarket contract parsing, discovery, settlement, listings, candles, fills, and order books with the same row fields
- Economy: CPI, PPI, payrolls, GDP, jobless claims, Fed decisions, first-print vintages
- Finance: completed and live earnings-call transcripts plus earnings-mention resolution

## Data contracts

- Temporal controls: sources with reliable availability timestamps can be filtered or checked against a research cutoff.
- Source identity: every frame names the feed that served it.
- Archive/live consistency: shared parser semantics and core measurements, with runtime-specific fields kept explicit.
- When a live source returns no rows, the call raises `NoLiveDataError` instead of substituting archive data.

## Docs

- Overview: https://mostlyright.md/docs/
- Quickstart: https://mostlyright.md/docs/quickstart/
- Packages: https://mostlyright.md/docs/sdk/
- Temporal safety: https://mostlyright.md/docs/concepts/temporal-safety/
- Data sources: https://mostlyright.md/docs/concepts/data-sources/
- Weather observations: https://mostlyright.md/docs/guides/weather-observations/
- Forecasts: https://mostlyright.md/docs/guides/forecasts/
- Daily summaries: https://mostlyright.md/docs/guides/daily-summaries/
- Satellite: https://mostlyright.md/docs/guides/satellite/
- Citizen weather: https://mostlyright.md/docs/guides/citizen-weather/
- Markets: https://mostlyright.md/docs/guides/markets/
- Trade history: https://mostlyright.md/docs/guides/trade-history/
- Economy: https://mostlyright.md/docs/guides/econ/
- Finance: https://mostlyright.md/docs/guides/finance/
- Full details: https://mostlyright.md/llms-full.txt