⚡ Polyxo Terminal

The open-source Polymarket intelligence desk — built for execution, alpha, and consistency.

---

🚀 Run the Terminal — One Line

pip install polyxo-terminal && polyxo

That's it. Live books, tape, news wires, charts, and AI agent lanes — no signup, no paywall, no config file required.

---

🎯 What Is Polyxo?

Polyxo is a Bloomberg-style terminal for Polymarket — a dense, keyboard-first TUI that gives you everything you need to discover markets, read liquidity, route agents, and execute without leaving your shell.

We built Polyxo because prediction markets reward speed, conviction, and consistency — not the ability to juggle 20 browser tabs. Intelligence is everywhere now; the bottleneck is wiring it into a desk that runs.

Our path is simple: Discover → Launch → You profit.

🔑 Key Features

	Feature	Description
📊	Live market browser	Real-time Polymarket discovery, search, and metadata
📕	Order-book depth	Six-deep CLOB snapshots for YES / NO outcome tokens
📈	Charts & indicators	Candlestick charts with moving averages and volume
📰	News wires	Multi-source news feeds with sentiment context
🤖	Agent lanes	Resolver, liquidity, arb, risk, macro, and news agents
🎯	Watchlists & alerts	Track markets and get threshold-based notifications
💹	Tape	Real-time trade flow and volume pulse
🧠	AI copilot	Context-aware research powered by OpenAI / Anthropic / local models
🔧	Fully composable panes	Split, stack, and save layouts like a real trading desk
🔒	Read-only by default	No accidental orders — trading requires explicit opt-in

---

🖥️ Terminal Preview

News, chart, watchlist, copilot, six-deep book, and tape — composed the way serious desks actually stack signal.

---

⚙️ Core Commands

:search election odds        # find markets
:open <market-slug>          # load a market
:event <market-slug>         # full event detail
:book <market-slug> yes      # order-book depth
:watch <market-slug>         # add to watchlist
:research <market-slug>      # deep research view
:alert <slug> yes > .62      # price alert
:agent resolver <slug>       # spin up agent
:agent liquidity <slug>      # liquidity analysis
:split h book                # split pane
:workspace save my-layout    # save desk layout
:help                        # full command reference
:q                           # quit

---

🤖 Agent Personas

Polyxo ships focused Polymarket AI roles — not generic investing prompts:

Agent	Focus
🔍 resolver	Resolution criteria, ambiguity, source risk
💧 liquidity	Spread, depth, slippage, executable size
📰 news	Catalysts and information quality
⚖️ arb	Related-market inconsistencies
🛡️ risk	Binary downside, correlation, deadline traps
🌍 macro	Political, macro, sports, crypto context

Set POLYXO_OPENAI_API_KEY, POLYXO_ANTHROPIC_API_KEY, or any LiteLLM-compatible provider to power live agent output. Without keys, panes render useful offline prompts and role checklists.

---

🏗️ Architecture

Polyxo is organized around a clean module map with Greek-inspired naming:

Module	Role
oracle	Data providers (Polymarket, CCXT, yFinance)
phalanx	Pane system, workspace tree, composable layouts
ballista	Broker adapters (Alpaca, Kraken, Tradier, paper)
strategoi	Agent runtime and persona YAML configs
forge	Data pipeline and cache layer
armory	Quant tools — DCF, risk, QL modules
basilica	AI service layer and event bus
herald	Alert engine
muse	Charting and technical indicators
aegis	Credential vault (keyring-backed)

Full architecture docs live in docs/architecture.md.

---

🔧 Configuration

polyxo init   # writes ~/.polyxo/config.toml

Environment variables:

POLYXO_CONFIG_DIR=~/.polyxo
POLYXO_GAMMA_URL=https://gamma-api.polymarket.com
POLYXO_CLOB_URL=https://clob.polymarket.com
POLYXO_MARKET_WS=wss://ws-subscriptions-clob.polymarket.com/ws/market
POLYXO_CLOB_API_KEY=...
POLYXO_CLOB_SECRET=...
POLYXO_CLOB_PASSPHRASE=...
POLYXO_OPENAI_API_KEY=...
POLYXO_ANTHROPIC_API_KEY=...

---

🛡️ Trading Safety

Polyxo starts read-only by default. Account panes detect configured CLOB credentials, but live order placement is intentionally blocked until signer support is explicitly configured and confirmed. No accidental live orders — ever.

---

🧑‍💻 Development

git clone https://github.com/AlDevCoded/Polyxo.git
cd Polyxo
pip install -e ".[dev]"
pytest
ruff check src tests
polyxo --version

Want to add a data provider? Implement DataProvider and register via entry point. Want to add a broker? Implement BrokerAdapter.

See our Contributing Guide for the full workflow.

---

🔗 Links

🌐 Website	polyxo.fun
𝕏 Twitter / X	@PolyxoTerminal
📦 PyPI	pip install polyxo-terminal
🐛 Issues	GitHub Issues
🤝 Contribute	CONTRIBUTING.md

---

💚 100% Open Source, We Want More Winners

Polyxo is 100% free and open source — forever. We will never charge for the core terminal. Our team is focused on one thing: condensing the path from Discover → Launch → You profit so you can make money on Polymarket from day one, not after a multi-week setup.

Intelligence is cheap — calendar time is what bleeds you. We ship meaningful updates at least three times a week to keep tightening routes, panes, and agent lanes.

Fork it. Break it. Improve it. The repo is the contract.

---

⚠️ Disclaimer

Polyxo is prediction-market research software. It does not guarantee profit, does not eliminate market risk, and should not be treated as financial, legal, tax, or investment advice. Prediction markets carry real risk; users are responsible for their own decisions and compliance obligations.

---

_{Built with 🖤 for the Polymarket community}