> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.whalehunt.net/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.whalehunt.net/_mcp/server.

# Polymarket Realtime Data

Whalehunt's Polymarket Realtime Data service turns supported Polygon observations into a structured event stream. It can report an observed intent, what a successful transaction receipt establishes, and later changes to the status of an inclusion.

Your application subscribes to authorized wallet or market scopes over WebSocket. It receives typed events, source-quality notices, and checkpoints that let a durable consumer resume after a disconnect.

> **Access is currently coordinated**
>
> This guide describes the v1 wire protocol for approved access. Availability, endpoint details, account scopes, and operating limits are provided with your access; this page does not publish a public endpoint or self-serve signup flow.

## What the stream contains

* Preliminary participation observations when a supported source exposes them. They are not proof that a transaction will execute.
* Receipt-backed transaction outcomes and normalized execution amounts when the receipt is supported by the normalizer.
* Explicit inclusion status and corrections when later chain observations change an earlier assessment.
* Replay and checkpoints for resuming a saved subscription, plus source-quality information for interpreting quiet periods.

An execution may arrive without an earlier pending observation. Receipt inclusion is not the same as finality, and a later correction does not create a second execution.

## What it is not

This is not a CLOB order book, an order-placement or trading API, or a SQL archive of all historical activity. The stream reports supported observations; it does not claim that every pending transaction or every possible relationship between an intent and an execution is visible.

## Choose your next step

#### [Get access](/polymarket/access)

Confirm the connection details, authorized scopes, and limits for your account.

#### [Read the protocol reference](/polymarket/reference/frames)

Inspect the client and server WebSocket frame shapes.

#### [Understand the lifecycle](/polymarket/concepts/lifecycle)

Distinguish intent, receipt, inclusion, finality, and corrections.

#### [Build a durable consumer](/polymarket/stream/recovery)

Apply events, persist checkpoints, and recover after disconnects.