predxt-web-dashboard

FastAPI + Vite React live dashboard starter powered by predxt.

This repo is a public, read-only example for building prediction-market monitoring tools. It shows stream health, latest normalized events, and an orderbook panel. It does not place orders, manage accounts, or provide trading advice.

Quickstart

Run the backend:

uv sync --group dev
uv run uvicorn predxt_web_dashboard.app:app --reload

Run the frontend in another terminal:

cd frontend
npm install
npm run dev

Open the Vite URL, usually http://localhost:5173. The default demo stream is offline-safe and does not require venue credentials.

Docker

docker build -t predxt-web-dashboard .
docker run --rm -p 8000:8000 predxt-web-dashboard

Then open http://localhost:8000.

Live Polymarket Stream

The UI can connect to a public Polymarket asset id:

70771354585365381988139008309072205730081182435161568795508496003376222185889

Live streams depend on venue websocket availability. CI only exercises the offline demo path.

API Surface

• GET /api/health: service and boundary metadata.
• GET /api/demo/orderbook: offline orderbook fixture using predxt types.
• WS /ws/demo: repeating offline normalized event stream.
• WS /ws/polymarket?asset_id=...: read-only public Polymarket stream.

Boundary

• Read-only realtime ingestion only.
• No financial advice.
• No order placement or execution.
• No secrets are committed or required for the offline demo.