predxt 0.3.0: guided first orderbook

predxt 0.3.0: find a market and read its first orderbook

This release adds a guided first-run workflow for Polymarket. Search by name,
choose a market and outcome, and get an orderbook snapshot without manually
looking up the outcome's token ID.

pip install "predxt>=0.3.0"
predxt demo
predxt explore polymarket --query "bitcoin"

• predxt demo displays a clearly labelled synthetic orderbook, without network
  access, credentials, or repository files. --json emits structured output.
• predxt explore polymarket shows one REST snapshot and prints a WebSocket
  command with the selected token ID. API requests have a configurable deadline;
  scripts can pass --market-id, --outcome-index, and --json.
• Polymarket text search now uses Gamma's documented /public-search endpoint.
  It flattens event markets, removes duplicate IDs, retains raw payloads, and
  supports keyword-only active_only=True. Results come from the first page;
  nonpositive limits now raise ValueError.
• First-run documentation and installed-wheel CI checks cover the complete
  onboarding path, including unavailable markets, invalid selections, and API errors.

Python 3.12 or later is required. Existing REST and WebSocket imports remain
available. This release continues the read-only market-data scope.

First-run guide ·
PR #14 ·
Full changelog

v0.2.2

Fixes graceful websocket stream exhaustion for Polymarket, Kalshi, and Opinion. Clients now mark connection health false, count the reconnect, wait for backoff, reconnect and restore subscriptions. Opinion replaces the old heartbeat. Explicit close interrupts retry waits, and cancellation/iterator closure releases resources without reconnecting.

Public imports and the existing raw payload contract are preserved.

Validation: 94 tests passed in CI on Python 3.12 and 3.13. Fresh installations of both the public PyPI wheel and sdist each passed all 36 lifecycle regressions. Published artifact hashes and source identity were verified against release commit e2bc5ed4b73272dfa414aafb133f718176b09283.

Install: pip install predxt==0.2.2

PyPI package · Verification evidence

What's Changed

• Fix graceful websocket reconnect and release 0.2.2 by @nekrasovp in #13

Full Changelog: v0.2.1...v0.2.2

v0.2.1

What's Changed

• Fix CI version check and verify Pages deployment by @nekrasovp in #8
• Fix idle ConnectionManager shutdown by @nekrasovp in #10
• Prepare v0.2.1 release by @nekrasovp in #11

New Contributors

• @nekrasovp made their first contribution in #8

Full Changelog: v0.2.0...v0.2.1

v0.2.0

Full Changelog: v0.1.0...v0.2.0

v0.1.0

Full Changelog: https://github.com/hzprotocol/predxt/commits/v0.1.0