v0.1.1
macOS · Linux
Python 3.12+

~ $ polymarket-tui

Polymarket in your terminal_

Browse every market, watch order books tick live, chart price history, track your P&L, and place orders — all keyboard, no browser.

No account to browse / starts in dry-run / open source

polymarket-tui — recorded session dry-run · balances hidden · 160×42

Open the top market → cursor the live book → place a buy (dry-run: signed, never posted) → flip to the NO book → chart → the trade tape and a top trader → search. Real exchange, real data. Install it.

01Features

The whole exchange, rendered in text

The full surface of Polymarket as a dense, fast, keyboard-native interface. No mouse required.

01Browse every market

Trending, Politics, Sports, Crypto and more, sorted by volume or liquidity. / searches markets and traders.

02Live order books

YES/NO books and the trade tape stream straight from the CLOB. Cursor a level; space starts an order right there.

03Price charts

Full price history inline for any market or outcome. Arrow across the chart to inspect any point in time.

04Portfolio & P&L

Positions, cash, and profit history for your wallet — or any public trader's book, read-only.

05Order entry

Limit and market orders under the live book, priced in cents. Decimal-exact, validated, audited to a local log.

06Dry-run by default

Every session starts DRY: orders are built and signed, never posted. Going LIVE is an explicit, confirmed opt-in.

02Keymap

A small core of keys, one meaning each

Arrows move and drill everywhere; space is always the contextual toggle. Press ? in the app for the full reference.

move · drill in · step out
spacecontextual toggle everywhere
tabcycle category / timeframe / pane
bsbuy / sell under the live book
/search markets & traders
pwportfolio / watchlist
Larm LIVE for the session
?qkey reference / quit
03Access

Nothing to sign up for

Browsing needs no account at all. Add credentials only to see your own portfolio or to trade — and trading stays dry-run until you say otherwise. Account setup ↗

noneBrowse

Markets, books, charts, trades, and any trader's public positions — read-only, no credentials.

addressObserve

Add your funder address to follow your own positions, cash, and profit history.

keyTrade

Add a private key to place orders. Every session is DRY until you explicitly go LIVE.

04Install

Four ways to install

Python 3.12+. On PyPI and Homebrew; the curl script installs uv for you if it is missing.

# pypi
$
uv tool install polymarket-tui
# homebrew
$
brew install byronxlg/tap/polymarket-tui
# one-liner
$
curl -sSL https://raw.githubusercontent.com/byronxlg/polymarket-tui/main/install.sh | bash
# from source
$
git clone https://github.com/byronxlg/polymarket-tui
cd polymarket-tui && uv sync && uv run polymarket-tui
05Blog

Notes from the order book

Short posts on prediction markets and trading them from the terminal: what the numbers mean and how to act on them.

All posts · RSS

06Digest

The day's markets, in your inbox

One email each morning: the biggest 24-hour movers, where the volume is, markets about to resolve, and new markets already attracting money.

@

Double opt-in: nothing is sent until you click the confirmation link. Every email carries an unsubscribe link. Your address is used for the digest and nothing else.

Disclaimer Unofficial client, not affiliated with Polymarket. It can place real orders with real money when LIVE mode is explicitly enabled; you are responsible for your trades. No warranty. Deposits, withdrawals, and redemptions are on-chain operations this client does not perform — use the website.

Data from public Polymarket APIs: gamma-api.polymarket.com, clob.polymarket.com, data-api.polymarket.com, user-pnl-api.polymarket.com.