A terminal UI for browsing and monitoring Polymarket prediction markets in real-time. Built in Rust with a beautiful TUI interface.
This was started as a pet project for me to play with AI. This used Cursor, Claude and Codex.
- Multiple tabs: Events, Favorites, Breaking, and Yield views
- Events: All events sorted by 24h trading volume
- Favorites: Your bookmarked events (requires authentication)
- Breaking: Markets that moved the most in the last 24 hours (shows price change %)
- Yield: High-probability markets for yield opportunities
- Real-time trade monitoring: Watch live trades via WebSocket (RTDS)
- Live price updates: See current prices for all market outcomes
- Trade counts: View number of trades per event
- API search (
/): Search all Polymarket events via API - Local filter (
f): Filter current list locally - Keyboard navigation: Vim-style bindings (
j/k,↑/↓) - Mouse support: Click to select, scroll panels, switch tabs
- Panel navigation: Tab between Events, Details, Markets, Trades, and Logs
- Event details: Title, slug, status, end date, tags
- Market outcomes: Prices for Yes/No or multiple outcomes
- Volume indicators: 24h volume, total volume
- Status indicators: Active, closed, in-review states
- CLOB API authentication: Required for trade counts and favorites
- Bookmark events: Save favorite events for quick access
- User profile: View your Polymarket profile in the TUI
- Logs panel: View API calls and debug info (
lto toggle) - URL opening: Open event in browser (
okey) - Infinite scroll: Load more events as you scroll
- Cache: Events are cached per tab for fast switching
crates/polymarket-api: Core library with WebSocket client, Gamma API client, CLOB client, and display formatterscrates/cli: Binary application with TUI and CLI commands
cargo install polymarket-tuiOr build from source:
git clone https://github.com/penso/polymarket-tui
cd polymarket-tui
cargo build --release# Start TUI (default - no arguments needed)
polymarket-tui
# Or explicitly with options
polymarket-tui trending --order-by volume24hr --limit 100# Watch live trades for a specific event
polymarket-tui watch-event <event-slug-or-url>
# Monitor all markets via WebSocket
polymarket-tui monitor
polymarket-tui monitor --rtds --event <event-slug>
# Get orderbook for a market
polymarket-tui orderbook <market-id>
# Get recent trades
polymarket-tui trades <market-id> --limit 20
# Get event/market information
polymarket-tui event <event-slug>
polymarket-tui market <market-slug>
# Find yield opportunities
polymarket-tui yield --min-prob 0.95 --expires-in 7d| Key | Action |
|---|---|
↑/k, ↓/j |
Navigate up/down |
Tab |
Switch between panels |
←/→ |
Switch tabs |
1-4 |
Jump to tab (Events/Favorites/Breaking/Yield) |
Enter |
Toggle live trade watching |
/ |
Search markets (API) |
f |
Filter current list (local) |
r |
Refresh current panel |
b |
Toggle bookmark (requires auth) |
o |
Open event URL in browser |
l |
Toggle logs panel |
p |
Show user profile |
? |
Show help |
Esc |
Cancel/close |
q |
Quit |
For features like favorites and trade counts, set these environment variables:
export POLYMARKET_API_KEY="your-api-key"
export POLYMARKET_SECRET="your-secret"
export POLYMARKET_PASSPHRASE="your-passphrase"Or create an auth.json file (see envrc-example).
# Build
cargo build
# Run TUI
cargo run -p polymarket-tui -- trending
# Run tests
cargo test
# Run lints
cargo clippy --all-targets --all-features -- -D warnings
# Format code
cargo fmtThe library provides these main modules:
gamma: Client for Polymarket's Gamma API (events, markets, user profiles)clob: Client for CLOB API (orderbooks, trades, authentication)rtds: Real-Time Data Stream client for live trade activitywebsocket: WebSocket client for market updatesdisplay: Formatters for colored console outputcache: File-based caching for API responses
GitHub Actions runs on pushes and PRs:
- rustfmt check
- clippy with warnings denied
- full test suite
MIT