# predxt

Read-only Python SDK for prediction-market websocket ingestion and REST
market-data snapshots.

## Use predxt for

- live market-data recorders
- orderbook dashboards
- monitoring agents
- research tools
- read-only scanners

## Do not use predxt for

- placing orders
- account management
- trading advice
- credential generation
- bypassing venue restrictions

## Install

```bash
pip install predxt
```

## Core APIs

```python
from predxt import OrderBookState, VenueMessage, typed_event_from_message
from predxt.polymarket import PolymarketRestClient, PolymarketWsClient
from predxt.kalshi import KalshiRestClient, KalshiWsClient
from predxt.opinion import OpinionRestClient, OpinionWsClient
```

`VenueMessage` fields: `venue`, `raw_data`, `timestamp_ms`, `event_type`,
`market_id`, `asset_id`, `received_at_ms`.

Typed event classes: `OrderBookSnapshot`, `OrderBookDelta`, `TradeEvent`,
`PriceChangeEvent`.

REST model classes: `MarketSummary`, `MarketDetail`, `OrderBookLevel`,
`VenueCredentialStatus`, `VenueApiError`.

REST clients expose `search_markets`, `get_market`, `get_orderbook`, and
`healthcheck`/`test_credentials`.

## CLI

```bash
predxt parse-fixture --venue polymarket --jsonl tests/fixtures/polymarket_order_books.json
predxt stream polymarket --asset-id 1234567890 --limit 10 --jsonl
```

## Agent guidance

- Preserve raw payload access.
- Keep generated apps read-only.
- Use env vars or secret managers for Kalshi and Opinion credentials.
- Prefer `OrderBookState` for simple dashboards; do not claim execution-grade semantics.

More context: `llms-full.txt`, `docs/`, `skills/predxt/SKILL.md`.
