CLI - PolyNode

The PolyNode CLI (pn) gives you instant access to every PolyNode feature from the terminal. Watch live settlements scroll by, view full-depth orderbooks with bid/ask visualization, track short-form crypto markets with countdown timers, and monitor Chainlink price feeds. Every command also supports --json for programmatic use by agents and scripts.

Install

# From source (requires Rust)
cargo install --git https://github.com/joinQuantish/polynode-cli

The binary is called pn.

Authentication

The CLI resolves your API key in this order:

--key flag: pn markets --key pn_live_...
POLYNODE_API_KEY environment variable
~/.config/polynode/key file (auto-saved when you run pn key create)

# Generate a free API key (auto-saves to ~/.config/polynode/key)
pn key create

Commands

Command	Type	Description
`pn key create [name]`	REST	Generate a new API key
`pn status`	REST	System status and metrics
`pn markets [--count N]`	REST	Top markets by 24h volume
`pn search <query>`	REST	Full-text market search
`pn market <slug-or-id>`	REST	Single market detail
`pn stream [type]`	Live TUI	Scrolling real-time event feed
`pn orderbook <slug-or-id>`	Live TUI	Full-screen bid/ask depth view
`pn short-form <5m\|15m\|1h>`	Live TUI	Multi-coin crypto dashboard
`pn chainlink`	Live TUI	Live Chainlink price feeds

Every command supports --json for machine-readable output.

Static Commands

Markets

View the top markets by 24h trading volume.

pn markets --count 10

Search

Full-text search across all market questions.

pn search "bitcoin"

Status

System health, connection count, and state metrics.

pn status

Market Detail

Look up a single market by slug or token ID.

pn market will-bitcoin-reach-150k-in-march-2026

Live TUI Commands

Live commands open a full-screen terminal UI that updates in real-time. Press q or Esc to exit.

Stream

Watch every settlement, trade, block, or oracle event as it happens.

# All settlements
pn stream settlements

# Large trades only (> $100)
pn stream settlements --min-size 100

# Filter by wallet
pn stream settlements --wallets 0xabc...

# Other event types
pn stream trades
pn stream blocks
pn stream oracle
pn stream global

Events are color-coded: yellow for pending, green for confirmed. The header shows event count and throughput rate.

Orderbook

Full-depth live orderbook with proportional bid/ask bars. Green bars show bid depth growing left, red bars show ask depth growing right.

pn orderbook btc-updown-5m-1774077000
pn orderbook will-bitcoin-reach-150k-in-march-2026

Use arrow keys to scroll deeper into the book. The footer shows midpoint, spread, total updates, and update rate.

Short-Form Dashboard

Multi-coin dashboard for Polymarket’s short-form crypto markets. Shows all 7 coins (BTC, ETH, SOL, XRP, DOGE, HYPE, BNB) with beat price, direction, odds, liquidity, volume, and a countdown timer. Auto-rotates to the next window when the current one expires.

# 5-minute windows
pn short-form 5m

# 15-minute, specific coins
pn short-form 15m --coins btc,eth,sol

# Hourly
pn short-form 1h

Chainlink Price Feeds

Live Chainlink data stream prices with bid/ask.

pn chainlink

JSON Mode (for Agents)

Every command supports --json for programmatic use. Static commands output pretty-printed JSON. Streaming commands output newline-delimited JSON (NDJSON), one object per line, with no TUI.

# Static: pretty JSON
pn markets --count 5 --json

# Streaming: NDJSON (one event per line, no TUI)
pn stream settlements --json

# Pipe to jq
pn stream settlements --json | jq '.taker_size'

# Orderbook snapshots as JSON
pn orderbook btc-updown-5m-1774077000 --json

This makes pn composable with standard Unix tools and usable as a data source for automated trading agents.

Key Bindings (TUI)

Key	Action
`q` / `Esc`	Quit
`Ctrl-C`	Quit
`Up` / `Down`	Scroll orderbook depth
`Home`	Reset scroll to top of book

​Install

​Authentication

​Commands

​Static Commands

​Markets

​Search

​Status

​Market Detail

​Live TUI Commands

​Stream

​Orderbook

​Short-Form Dashboard

​Chainlink Price Feeds

​JSON Mode (for Agents)

​Key Bindings (TUI)