How to Chart Polymarket Price History in the Terminal

Polymarket's own price-history API returns exactly what a chart needs - timestamps and prices, nothing else - but reading a JSON array of them tells you nothing about the shape of a move. polymarket-tui turns that same endpoint into a chart in the terminal: six time windows, up to six outcomes overlaid on one axis, and a crosshair that steps back through the series one candle at a time. Below is what it draws for a live market - Polymarket's Fed September rate-decision event, as of 2026-08-24 07:37 UTC.

One endpoint, six windows

Every price chart on Polymarket, on the website or here, reads from the same public CLOB endpoint: clob.polymarket.com/prices-history, called with a token ID and either a relative window (interval=1h|6h|1d|1w|1m|max) or an explicit startTs/endTs range in epoch seconds, plus a fidelity in minutes that sets how many points come back. It answers with a flat array of {"t": ..., "p": ...} pairs and nothing else - no volume, no OHLC candles, just a price at a time. In polymarket-tui those six relative windows are the tabs sitting right above the chart (1H 6H 1D 1W 1M ALL), cycled with tab or selected directly; each maps to a fidelity fine enough to look smooth without asking the API for more points than the terminal has columns to draw. No account is needed - the endpoint is public, and browsing charts never touches your credentials.

A single outcome, or every outcome at once

A market page charts one line at a time: whichever side of the YES/NO pair is currently selected, flipped with tab the same as everywhere else in the app, redrawing instantly. An event page - the one listing every contract in a multi-outcome market - overlays up to six lines on the same axis instead, picked as the highest-priced outcomes so the contracts actually worth watching lead. That is the more interesting view when an event's story is one contract crossing another, not just a single number going up. Polymarket's "Fed Decision in September?" event is a clean example: five yes/no contracts, one per possible outcome, two of them genuinely contested right now.

The two lines move as near mirror images: No Change ran from 63.5c up to a 74.5c peak around August 15-17 as a run of soft data landed, then eased back to 67.5c; Increase 25bps fell from 34.5c to a 24.5c low over the same stretch before climbing back to 31.5c. On the event page all five contracts in the ladder draw together, so a shift like this - one outcome gaining exactly as another gives it back - shows up as two lines crossing apart rather than something you'd have to notice by flipping between five separate tabs:

FED DECISION IN SEPTEMBER - PRICE   24H
Decrease 50+ bps                    0.25c   (flat)
Decrease 25 bps                     1.25c  -0.10c
No change                          67.50c  -1.00c
Increase 25 bps                    31.50c   +1.00c
Increase 50+ bps                    0.45c   (flat)

Freeze it and step through with a crosshair

x, bound on whichever screen owns the chart, focuses the panel and drops a crosshair on it; on an event page, arrow-down past the last row of the outcome table flows straight into the same inspect mode - down means down, whatever's below the table. Once inspecting, left/right step the crosshair through the series a small amount at a time (roughly 1.5% of the visible window per press), shift+left/shift+right jump ten times as far per press for covering a wide window fast, and escape, x, up, or down all exit cleanly and hand focus back to wherever it came from. While inspecting, the legend swaps the live price-plus-24h-change it normally shows for the exact price at the crosshair's timestamp - put it on a spike and read precisely how high the line went and when, instead of eyeballing a pixel against the axis.

Resizing live, not a static screenshot

Because the chart is real Rich/Textual output rather than an image, it redraws at whatever width the pane happens to be - a five-line event chart like the Fed one above is legible at full width and still readable compressed into a narrower drill pane, something a fixed-size embed can't do. In polymarket-tui, every market and event page carries one, no account required to browse it, and the same interval tabs and crosshair work identically whether you're watching a two-sided coin flip or, like this Fed event, a five-way ladder with two contracts actively trading places.

$ uv tool install polymarket-tui
$ polymarket-tui

No account is needed to browse markets, books, and charts. The install page has Homebrew and one-liner options.