Skip to main content
Back to Docs
🔍Intelligence

Realtime Stream

Live SSE feed of every trade, move and whale event

The Realtime Stream is a live, no-refresh feed of market activity across Polymarket and Kalshi. Open it at /dashboard/realtime and leave it running: prices, volume, and the biggest movers update on their own while you work. It is built as a heads-up display (HUD) — a single screen you keep visible on a second monitor or phone so you never miss a market repricing while you are reading signals, sizing a position, or watching a whale.

This page is read-only intelligence. It shows you what is happening; it does not place orders. Execution lives in Live Trading and the bot stack. The Realtime Stream exists to give you the fastest possible awareness of movement, so you can act in the right tool a few seconds sooner.

How It Works

The page asks our servers for a fresh snapshot every 30 seconds and replaces the table in place. There is no persistent connection: each refresh is an ordinary authenticated request to /api/realtime/markets, the response is cached at the edge and shared between users, and nothing stays open between refreshes.

That design is deliberate. An earlier version used a long-lived Server-Sent Events stream, which kept a server function alive for the whole session per viewer — expensive, and no better for you at this cadence, because the upstream data does not change every second anyway. Thirty seconds of granularity is what the feed can honestly deliver.

Two consequences worth knowing:

  • The feed pauses when the tab is hidden. Switch tabs or lock your phone and the page stops polling; come back and it fetches immediately, then resumes the 30-second rhythm. You are never billed attention — or requests — for a screen nobody is looking at.
  • Authentication is checked on every refresh. Because each snapshot is its own request, a session that expires or is revoked stops the feed at the next tick, not at some later cleanup.

Each row carries:

  • Market question — the contract being priced
  • YES price and NO price, shown in cents (e.g. 63.0¢)
  • 1h change and 24h change as percentages, colored teal for up and rose for down
  • Volume, abbreviated (1.2M, 48k)

At the top, a Top Movers strip surfaces the five markets with the largest absolute 1-hour move, regardless of direction. That is your at-a-glance "what is hot right now" panel — the markets most likely to be reacting to fresh news or a large order hitting the book.

A note on the change percentages: they reflect the real price delta reported upstream. When the source does not provide a 1h or 24h delta for a given market, the field reads 0 / rather than a fabricated number. If you see a flat 0.0%, that means "no reported movement," not "we made something up."

Status Pill and Timestamp

The top-left status pill reports the last refresh, not a connection:

  • LIVE (teal, pulsing dot) — the most recent snapshot arrived fine.
  • Reconnecting (rose, solid dot) — the last request failed, or the tab is in the background and polling is paused. The next successful tick flips it back.

Next to the pill, a last-updated timestamp shows the local time of the most recent snapshot, and a market count shows how many contracts are in the feed. Glance at the timestamp before you trust the numbers: prices are at most 30 seconds old when everything is healthy, and if the timestamp is minutes stale, treat the prices as indicative rather than exact.

How To Use It

  1. Open /dashboard/realtime from the sidebar. It starts on its own — there is no "start" button.
  2. Scan the Top Movers strip first. Those five cards tell you where the action is before you read a single table row.
  3. Use the filter box to narrow the table. Type any part of a market question — "election", "Fed", "BTC", a candidate name — and only matching markets remain. The filter is case-insensitive and matches substrings, so partial words work.
  4. Watch the rows you care about. New snapshots replace the table in place; rows do not scroll away or require a reload.
  5. When a market moves enough to act on, jump to the EV Scanner or the Market Detail view for that contract to confirm the edge, then size and execute in your trading tool of choice.

On mobile the layout switches automatically from a wide table to stacked cards — each market becomes a compact card with YES/NO, 1h, 24h, and volume — so the feed stays readable on a narrow screen without horizontal scrolling.

Turning It Off

There is nothing to turn off. Navigate away, switch tabs, or close the window and the polling stops by itself; nothing keeps running in the background. Return to the page and it fetches a fresh snapshot right away.

If you want a persistent HUD, dock the page in its own window or a second monitor and leave it open. Keep in mind that a background window counts as hidden for most browsers, so a HUD only refreshes while it is actually visible.

Plan Requirements

The Realtime Stream requires the Pro plan ($59/mo) or the Bot plan ($99/mo). It is not available on Starter ($29/mo) — that plan shows an upgrade gate instead of the feed.

Both paid tiers see the same feed; the difference is what you can *do* with the awareness:

  • Pro ($59/mo) — the full feed plus the analysis stack it pairs with: Whale Tracker, Arbitrage and the EV Scanner. Pro traders use it as a manual HUD.
  • Bot ($99/mo) — everything in Pro, plus live execution and automated strategies. Turning a move you spot here into an automatic order is the bot stack's job, not this page's.

To be explicit: spotting a move is available from Pro up, but placing a real order requires the Bot plan. The Realtime Stream never executes trades itself.

Tips for Using It as a HUD

  • Dock it and keep it visible. A glanceable feed beats refreshing a tab — just remember it sleeps while hidden.
  • Filter to your book. If you trade three or four markets at a time, type a keyword and keep the table tight. Less noise, faster reactions.
  • Read Top Movers like a radar. A market suddenly appearing there with a big 1h jump is your cue to investigate *why* — often there is fresh news. Cross-check the News & Calendar feed.
  • Confirm before you act. The feed tells you something moved; it does not tell you the edge is real. Use it to *trigger* analysis, then validate in AI Probability or the EV Scanner before sizing.

Common Gotchas

  • Flat 0.0% changes are not a bug. They mean the upstream source did not report a delta for that market. Read them as "no movement data," not "no opportunity."
  • 30 seconds is the resolution, not the promise of a tick. If a market moved and came back inside one interval, you will not see it here. This page is awareness, not a tape.
  • A hidden tab shows Reconnecting. That is the pause, working as intended, not a failure.
  • The feed stops when you leave the page — by design. This is not a notifications system. To be alerted while you are *not* watching, configure Notifications or an alert rule.
  • This is awareness, not automation. If you want the platform to *act* on moves without you watching, that is bots and copy trading on the Bot plan.

Related Docs