An open-source Polymarket terminal and market intelligence desk.
Track Polymarket flow, spot sharp 24h moves, surface extreme consensus probabilities, follow the live tape, manage watchlists and alerts, open public desks, and prepare order-intent plans from one fast probability cockpit.
Open the app · Features · V2 Status · Community · Quick start · API
| Signal | Why it is useful |
|---|---|
| 24h market movers | See where pricing changed before the story gets old |
| Top flow | Follow where attention and liquidity are concentrating |
| Consensus screens | Find markets priced near certainty but still unresolved |
| Probability edges | Surface extreme-price candidates worth deeper research |
| Live tape | Watch public trades print in real time |
| Optional accounts | Sign in with a handle/password to carry watchlists and alerts across devices |
| Shareable watchlists | Track and share a market set with account-backed or anonymous desks |
| Market detail | Inspect price, spread, liquidity, close time, recent trades, related markets, alerts, and watch actions |
| Probability ticket | Pick YES/NO, choose max spend, copy an order-intent plan, and open Polymarket to sign |
| Market Pit | Vote YES/NO with conviction and chat per market with anonymous aliases |
| V2 market desk | Since-last-open brief, named watchlists, in-app alerts, public desks, and privacy-light analytics |
| Daily brief export | Copy a shareable Markdown or plain-text market brief for posts, newsletters, and community updates |
Polymarket Desk is intentionally non-custodial and intent-only. It does not submit orders, connect wallets, custody funds, or require private Polymarket credentials. The probability ticket prepares an order-intent plan and sends users to Polymarket to sign.
Prediction markets are becoming a real-time layer for news, politics, sports, macro, crypto, AI, and internet culture. Polymarket has the liquidity and the narratives, but the default experience is optimized for browsing markets, not for operating like a trader.
Polymarket Desk turns public market data into an open-source operator console:
- See what the market is paying attention to.
- Catch 24h price dislocations before they disappear.
- Watch trade flow print live.
- Save and share a watchlist anonymously, or sign in to keep it across devices.
- Use the dashboard as a base layer for daily briefs, alerts, analytics, newsletters, bots, public desks, safer trade workflows, or paid tooling.
Every active prediction-market user asks the same questions:
- What is moving right now?
- Where is volume concentrating?
- What has the crowd priced as nearly certain?
- Which markets are mispriced if my view is different?
- What are other traders actually doing?
Polymarket Desk compresses those answers into one screen.
| Audience | Why they care |
|---|---|
| Prediction-market traders | Faster market scanning, watchlists, live tape, and catalyst detection |
| Reddit / Discord communities | A clean way to find probability moves, market heat, and shareable context without scrolling forever |
| Developers | A small, hackable Polymarket data app with serverless APIs and no framework overhead |
| Newsletter writers | A source for daily "top movers", "market heat", and "consensus watch" sections |
| Investors / YC-style reviewers | A wedge into the prediction-market tooling layer: dashboards, alerts, analytics, and trade infrastructure |
Polymarket Desk is public because prediction-market tooling should be hackable. If you trade, write, build bots, moderate a community, or just like market structure, there is useful work here.
The project is especially looking for contributors who want to:
- Improve market-ranking heuristics and explain why a screen is useful.
- Add better alert rules, delivery channels, and dedupe behavior.
- Build public desks for crypto, macro, sports, AI, geopolitics, and elections.
- Improve mobile, accessibility, empty states, and copy.
- Add historical snapshots, charts, fixtures, and API contract tests.
- Keep the probability ticket safe: no server-side private keys, no custody, no hidden execution.
Start with issues labeled good first issue or help wanted. Small PRs are welcome; one sharp improvement beats a giant rewrite.
Starter issues:
- Daily brief export MVP
- Add sparkline history to market detail
- Polish alert inbox messages and dedupe UX
- Create community public desk starter packs
- Add API fixtures for desks, alerts, and trade intent
- Mobile polish for market drawer and trade ticket
Prediction markets are still early, but the tooling gap is obvious. Crypto got block explorers, DEX screeners, wallet trackers, alert bots, and trading terminals. Prediction markets will need the same stack.
Polymarket Desk is a small wedge into that stack:
- Start with non-custodial intelligence, because it is safer and broadly useful.
- Build habits around watchlists and alerts, because traders come back when the market moves.
- Layer in data history and collaboration, because market context compounds.
- Keep execution user-signed, because private keys and order submission should not live on this server.
Production is deployed on Vercel:
https://polymarket-desk-seven.vercel.app
| Area | Purpose |
|---|---|
| Market Dashboard | Consensus markets, 24h catalysts, watchlist, and summary stats |
| Since Last Open | A daily brief-style block with recent movers, flow, closers, and tape activity |
| Trending | Top events, top movers, and highest-flow markets |
| Probability Edges | Heuristic screen for extreme prices with meaningful recent volume |
| Screens | High-conviction and top-flow filters for fast scanning |
| Live Tape | Recent public trades across Polymarket |
| Market Detail | Focused drawer with Polymarket link, bid/ask, spread, liquidity, recent trades, related markets, watchlist, alert, and order-plan actions |
| Market Pit | Per-market community votes and last-100-message anonymous chat |
| Watchlists | Legacy default watchlist plus named lists, import/export, clone, and read-only share links |
| Alerts | In-app alert rules and inbox for price, move, volume, closing-soon, and watchlist-change events |
| Public Desks | Curated desks for Top Movers, Crypto, Macro, Sports, AI, Geopolitics, and Extreme Consensus |
V2 grows Polymarket Desk from a fast market scanner into a lightweight market intelligence desk:
| Feature | Status | Product intent |
|---|---|---|
| Since Last Open Brief | Shipped | A quick read on watchlist movers, high-flow markets, closing-soon markets, and tape prints |
| Market Detail | Shipped | One focused view per market with price, liquidity, event context, recent trades, and watchlist actions |
| Probability Ticket | Shipped | Build a local order-intent plan and open Polymarket for user-side signing |
| Market Pit | Shipped | Per-market YES/NO conviction votes and anonymous last-100-message chat with basic anti-spam controls |
| Named Watchlists | Shipped | Human-readable lists for themes like elections, crypto, AI, sports, macro, or a community's favorite markets |
| In-App Alerts | Shipped | Browser-visible alerts for watchlist moves, volume spikes, consensus changes, and notable tape activity |
| Public Desks | Shipped | Curated public watchlists that can be linked from posts, newsletters, Discords, and research pages |
| Privacy-Light Analytics | Shipped | Aggregate usage signals for product decisions without wallets, trading keys, personal profiles, or invasive tracking |
| Daily Brief Export | Shipped | A copy-ready Markdown or plain-text summary of top movers, flow, consensus shifts, closers, watchlist moves, and tape prints |
These features should preserve the current boundary: Polymarket Desk can prepare intent, but users sign and execute on Polymarket.
- Built for scanning, not browsing: dense layout, tabbed screens, fast polling, and tape-first market context.
- No wallet required: useful to lurkers, researchers, traders, and builders before any transaction.
- Shareable watchlists: a simple URL can carry a market list across devices or groups.
- Fast probability tickets: choose side and max spend, then open Polymarket to sign without sharing keys with this app.
- Hackable architecture: no heavy frontend framework, simple Python APIs, easy to fork.
- Clear expansion path: richer alert delivery, market history, charts, fixtures, public desk packs, and workflow automation.
- Fast market triage: scan top markets, events, movers, and trade flow from one page.
- Probability discovery: rank markets with extreme implied probabilities and real liquidity.
- Optional login: browser-generated tokens still work, while handle/password accounts recover a stable account token across devices.
- Serverless data layer: Python functions aggregate public Polymarket APIs.
- No build pipeline: vanilla HTML/CSS/JS frontend, deployable directly on Vercel.
- Non-custodial by design: no trading keys, no wallet connection, no server-side order execution.
- Open it before trading to see where attention and liquidity are moving.
- Use
Probability Edgesto find extreme consensus markets worth researching. - Track a personalized watchlist across devices with a share link.
- Use the probability ticket to turn a market view into a clear order-intent plan before signing on Polymarket.
- Watch the live tape to understand what is actively printing.
- Share a watchlist link around a theme: elections, sports, crypto, AI, geopolitics.
- Use the dashboard as a "what is hot today?" reference.
- Publish public desks for recurring community threads, contest watchlists, or event-specific research.
- Pull screenshots for posts, threads, and daily discussion.
- Fork it as a starter for Polymarket data apps.
- Add Telegram, Discord, email, or webhook alerts.
- Store snapshots for historical charts.
- Build public desk directories around specific topics or communities.
- Build a richer API around market discovery and event tracking.
This is not just a dashboard. It is a wedge into prediction-market infrastructure:
- Market: prediction markets are becoming a real-time information and trading layer.
- User pain: active users need discovery, monitoring, alerts, and context.
- Initial wedge: free non-custodial dashboard with live utility.
- Expansion: daily briefs, market detail, named watchlists, alerts, public desks, historical analytics, premium screens, and safer execution-adjacent workflows.
- Distribution: Reddit, Discord, crypto Twitter, prediction-market communities, newsletters, and open-source developers.
| Layer | Tech |
|---|---|
| Frontend | Vanilla HTML, CSS, JavaScript |
| API | Python serverless functions on Vercel |
| Storage | Vercel KV / Upstash Redis |
| Hosting | Vercel |
| Data | Polymarket Gamma API and Data API |
Browser
|
| polls /api/state?u=<token>
v
Vercel Python Functions
|-- gamma-api.polymarket.com/markets
|-- gamma-api.polymarket.com/events
|-- data-api.polymarket.com/trades
`-- Vercel KV watchlist lookup
|
v
Single normalized dashboard payload
Repository layout:
.
|-- api/
| |-- state.py # Aggregates Polymarket markets, events, trades, watchlists, and alert events
| |-- market.py # Market detail, recent trades, related markets, and optional history
| |-- watchlist.py # Legacy default watchlist CRUD
| |-- watchlists.py # Named watchlists, import/export, edit links, and share links
| |-- alerts.py # Alert CRUD and rule evaluation helpers
| |-- analytics.py # Privacy-light aggregate event logging
| `-- desk.py # Curated public desks
|-- .github/ # CI, issue templates, and PR template
|-- docs/
| |-- LAUNCH.md # Public launch checklist and copy
| `-- screenshots/ # README screenshots and product tour
|-- public/
| `-- index.html # Single-page dashboard
|-- scripts/
| `-- check_repo.py # Zero-dependency repository quality checks
|-- .env.example # Vercel KV environment variable template
|-- vercel.json # Rewrites, CORS headers, and function limits
`-- README.md
Polymarket Desk uses public unauthenticated endpoints:
https://gamma-api.polymarket.com/marketshttps://gamma-api.polymarket.com/eventshttps://data-api.polymarket.com/trades
The API layer normalizes those upstream responses into a single /api/state payload used by the dashboard.
Returns the combined dashboard state.
Optional query parameter:
u: user token used to resolve the watchlist.
Representative fields:
| Field | Description |
|---|---|
ts |
API response timestamp |
safest |
High-consensus near-term markets |
today_movers |
Large 24h price movers with volume |
trending_markets |
Top individual markets by 24h volume |
events |
Top grouped events by 24h volume |
value_plays |
Heuristic extreme-price screen |
high_conv |
High-conviction screen |
top_flow |
Top liquid markets |
trades |
Latest public trade tape |
watchlist |
Resolved watchlist markets when u is provided |
cockpit |
Since-last-open brief, watchlist movers, closers, and tape highlights when u is provided |
alert_events |
Newly evaluated in-app alert events |
Returns one market detail payload with normalized market fields, recent trades, related markets, and optional history. The frontend uses this for the market drawer and probability ticket.
Resolves the current lightweight account profile for a signed-in desk.
Creates or opens a lightweight account with a handle and password.
{ "action": "signup", "handle": "probtrader", "password": "8+ characters", "adopt_token": "optional-anonymous-token" }Passwords are stored as PBKDF2-SHA256 hashes. The endpoint returns a stable acct_... token that the existing watchlist, alert, and Market Pit APIs use as u=<token>.
Returns named watchlists for a browser token.
Creates a named watchlist.
{ "name": "Crypto desk", "slugs": ["example-market-slug"] }Updates a named watchlist's name or slug list.
Deletes a named watchlist.
Returns saved watchlist slugs for the legacy default watchlist. Optional wl=<id> resolves a named watchlist while preserving backward compatibility.
Adds a slug to the watchlist.
{ "slug": "example-market-slug" }Removes a slug from the watchlist.
Returns in-app alert rules for a browser token.
Creates an alert rule for price crosses, 24h move thresholds, volume spikes, closing-soon markets, or watchlist changes.
Updates an alert rule.
Deletes an alert rule.
Returns one curated public desk such as crypto, macro, sports, ai, geopolitics, top-movers, or extreme-consensus.
Returns one market's Market Pit state: aggregate YES/NO conviction votes, the current anonymous user's vote, the latest visible messages, and posting limits.
Accepts vote, message, and report actions. The endpoint stores hashed anonymous user ids only, keeps the last 100 messages, blocks links/scripts/scams/threats, and hides messages after repeated reports.
Records aggregate, privacy-light product events. Do not send raw watchlist tokens, wallet data, IPs, private notes, or trading secrets.
Polymarket Desk supports both anonymous and signed-in desks. On first load, the browser generates an anonymous UUID and stores it in:
localStorage["polydash_user"]
That token is sent as ?u=<token> to the API. If the user creates or opens an account, /api/auth returns a stable acct_... token and the frontend replaces the anonymous token after optionally migrating watchlists and alerts.
Treat edit links and account tokens as bearer-style secrets. Anyone with an edit token can view and modify that desk. Account passwords are hashed server-side; Polymarket Desk still does not store wallets, Polymarket credentials, private keys, IPs, or user agents.
The value screen ranks markets with extreme implied prices, meaningful volume, and a medium-term horizon.
score = extremity * log(liquidity) * (1 + movement)
This is a discovery screen, not a trading recommendation. It highlights candidates for deeper independent research.
This repo is currently an open-source personal project, but the product direction is commercially plausible:
- Premium alerts for price moves, volume spikes, and watchlist changes.
- Saved dashboards and private watchlists for serious traders.
- Historical analytics and market backtesting.
- Newsletter or community intelligence product.
- API access for market discovery and event monitoring.
- Pro terminal for prediction-market power users.
- Watchlists are shareable by URL.
- Screenshots are naturally postable to Reddit, Discord, and X.
- Public desks turn community themes into reusable links.
- Daily briefs create a repeatable habit and a natural newsletter/social format.
- In-app alerts bring users back when watched markets actually move.
- The live demo gives immediate utility without signup.
- The open-source repo gives developers a reason to fork, star, and extend it.
- Each new alert/channel integration creates another distribution surface.
Prerequisites:
- Python 3.11+
- Current Vercel CLI for local serverless routing
uvon your PATH for the Vercel Python builder- Vercel KV / Upstash Redis if you want watchlist persistence
Clone and run:
git clone https://github.com/juliosuas/polymarket-desk.git
cd polymarket-desk
cp .env.example .env.local
vercel devIf vercel dev fails while trying to install uv into an externally managed Python, install uv directly first, for example with Homebrew:
brew install uvIf your local Vercel CLI asks uv for --python 3.0, upgrade the CLI and retry:
npm i -g vercel@latestThe app runs at:
http://localhost:3000
Without KV environment variables, market data can still render, but watchlist reads/writes will fail.
Run the lightweight repository check:
python3 scripts/check_repo.pyThe frontend is a single HTML file with embedded CSS and JavaScript. The API layer is a small set of Vercel Python functions:
api/state.pyaggregates market, event, trade, screen, watchlist, cockpit, and alert-event data.api/market.pypowers the market detail drawer and probability-ticket data.api/community.pypowers per-market Market Pit votes, chat, reports, and anti-spam limits.api/watchlist.pypreserves the legacy default watchlist contract.api/watchlists.pystores named watchlists and share/import/export flows.api/alerts.pystores and evaluates alert rules.api/desk.pyserves curated public desks.api/analytics.pyrecords aggregate privacy-light events.
This keeps the project easy to fork: no framework lock-in, no client build step, and no private Polymarket credentials.
Production expects Vercel KV variables:
| Variable | Required | Purpose |
|---|---|---|
KV_REST_API_URL |
Yes for watchlists | Upstash/Vercel KV REST endpoint |
KV_REST_API_TOKEN |
Yes for watchlists | Read/write token for /api/watchlist |
KV_REST_API_READ_ONLY_TOKEN |
Optional | Read-only token used by /api/state when resolving watchlists |
When Vercel KV is connected through the Vercel dashboard, these are injected automatically. Market data itself uses public Polymarket endpoints and does not require private credentials.
The project is configured for Vercel. Deploy through Vercel Git integration or the CLI:
vercel deploy --prodThe included GitHub Actions deploy-hook workflow is manual (workflow_dispatch) so the public repo does not fail CI when a fork has no Vercel secret. If you want to use it, create a Vercel Deploy Hook and save it as VERCEL_DEPLOY_HOOK_URL.
Current production URL:
https://polymarket-desk-seven.vercel.app
Contributions are welcome. Start with CONTRIBUTING.md and keep the product boundary non-custodial unless a separate risk and compliance design exists.
Good first areas:
- Better market filters and ranking heuristics.
- Alert integrations for Discord, Telegram, email, or webhooks.
- Public desk curation, historical snapshots, charts, and richer brief templates.
- More tests around API normalization and watchlist behavior.
- Accessibility, mobile polish, and copy improvements.
Use docs/LAUNCH.md before public posts, demo days, or community launches. It includes repository checks, product checks, suggested GitHub topics, and reusable launch copy.
- Add richer daily brief templates for topic desks, watchlists, and newsletter-ready formats.
- Improve alert inbox ergonomics and add richer event messages.
- Add historical sparkline snapshots for opened/detail markets.
- Add fixtures for public desk and alert evaluation tests.
- Improve community-facing copy and screenshots for open-source launch posts.
- Store broader historical snapshots for charts and momentum curves.
- Add Discord, Telegram, email, and webhook alert delivery.
- Add user accounts only if they improve collaboration while preserving no-custody defaults.
- Add community-submitted public desk templates.
- Backtesting for market-screen strategies.
- Team/shared desks for research groups.
- Premium data and pro filters.
- Optional deeper execution integrations, only after careful wallet, risk, compliance, and user-consent design.
- No server-side trading execution or wallet connection is implemented.
- The probability ticket creates an intent-only order plan and opens Polymarket for user-side signing.
- No Polymarket API keys are required.
- Watchlist state is keyed by opaque browser tokens.
- Market Pit hashes browser tokens before storage and never stores raw user tokens, wallet data, IPs, or user agents.
- Watchlist share links are bearer-style edit links.
- Analytics should stay privacy-light: aggregate page/screen usage, avoid wallet or trading identity, avoid selling behavioral profiles, and disclose tracking clearly.
- Real
.envfiles and.vercel/are ignored and should not be committed. - Sensitive vulnerability reports should follow SECURITY.md.
- No historical database or backfilled chart storage yet.
- No authenticated user accounts yet.
- Analytics are intentionally lightweight and should stay aggregate and transparent.
- Watchlists are simple slug arrays capped server-side; share links should be treated as bearer links.
- Market screens are heuristics and should be independently validated.
This project is for market monitoring and research. It is not financial advice, not a trading system, and not an endorsement of any market position. Trading prediction markets involves risk and may be restricted by jurisdiction.
MIT. See LICENSE.
Polymarket data belongs to its respective providers. This project is independent and is not affiliated with or endorsed by Polymarket.