---
title: "Live SSE stream of price deltas, whale prints and resolutions"
method: GET
path: "/api/prediction-markets/stream"
tags: ["public-pm-data"]
---

# Live SSE stream of price deltas, whale prints and resolutions

`GET /api/prediction-markets/stream`

## Request

- Base URL: `https://api.coinrithm.com`
- URL: `https://api.coinrithm.com/api/prediction-markets/stream`
- Auth: none required

Keyless Server-Sent Events stream. One connection delivers three named
event types, each a JSON payload:

- `deltas` — top snapshot price-deltas since the previous tick
  (`{at, deltas:[{source, slug, title, priceChange24h, volume24h,
  capturedAt}]}`)
- `whale` — newly observed verified large trades (same trade shape as
  `/api/prediction-markets/whales`; `{at, trades:[...]}`)
- `resolution` — freshly resolved events (`{at, resolutions:[{source,
  slug, title, resolutionState, resolvedAt}]}`)

Comment heartbeats (`: hb <iso>`) arrive roughly every 15 seconds —
treat a silence much longer than that as a dead connection and
reconnect (a `retry: 5000` hint is sent on connect). Feeds tick at a
15-second cadence; a row is delivered at most once per server poller
session. This is an information feed, not a recommendation stream.

## Response `200`

`text/event-stream`; named events `deltas`, `whale`, `resolution`
with JSON data frames, plus comment heartbeats.

## Other responses

- `503`: Stream at client capacity; retry later.

---

[API](https://skmtc.dev/coinrithm/apis/coinrithm-agent-trading-api.md) · [All operations](https://skmtc.dev/coinrithm/apis/coinrithm-agent-trading-api/llms.txt) · [OpenAPI document](https://skmtc.dev/coinrithm/apis/coinrithm-agent-trading-api/revisions/28fb59f285fe?raw)