> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kraken.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Derivatives WebSocket

> Real-time market data and account streaming for the Kraken Derivatives WebSocket API

Real-time market data and streaming account updates for Kraken's
Derivatives market.

<Note>
  Derivatives WebSocket is **streaming-only**. Order entry on Derivatives
  is handled via the [Derivatives REST
  API](/exchange/guides/futures/rest) or the
  [Unified FIX API](/exchange/api-reference/unified-fix). For end-to-end
  guidance, see the
  [Derivatives Introduction](/exchange/guides/futures/introduction).
</Note>

## Endpoint

```text theme={null}
wss://futures.kraken.com/ws/v1
```

A colocated endpoint is available alongside the Derivatives REST and
Unified FIX surfaces. Connection details are provided during
onboarding.

## Authentication

Private feeds use a signed-challenge model:

1. Connect to the WebSocket endpoint.
2. Request a challenge using your `api_key`.
3. Sign the challenge with your `api_secret` (SHA-256 → HMAC-SHA-512 →
   Base64).
4. Include both `original_challenge` and `signed_challenge` in every
   `subscribe`/`unsubscribe` for private feeds.

The signing flow is documented in full in the [Derivatives WebSocket
guide](/exchange/guides/futures/websockets#sign-challenge).

## Quick start

<CardGroup cols={2}>
  <Card title="book (L2)" icon="layer-group" href="/exchange/api-reference/futures-websocket/book">
    Order book snapshots and incremental updates.
  </Card>

  <Card title="ticker" icon="chart-line" href="/exchange/api-reference/futures-websocket/ticker">
    Best-bid / best-offer with funding and mark.
  </Card>

  <Card title="open_orders" icon="receipt" href="/exchange/api-reference/futures-websocket/open_orders">
    Private open-order snapshot and updates.
  </Card>

  <Card title="fills" icon="circle-check" href="/exchange/api-reference/futures-websocket/fills">
    Per-fill execution stream.
  </Card>
</CardGroup>

The complete public catalog (`book`, `ticker`, `ticker_lite`, `trade`,
`heartbeat`) and private catalog (`open_orders`,
`open_orders_verbose`, `open_position`, `balances`, `fills`,
`account_log`, `notifications`, `challenge`) is available in the
**Derivatives WebSocket** dropdown in the left navigation.

## Connection management

Send a ping at least every 60 seconds to keep the connection open. On
reconnect, re-issue subscribe requests for each feed; most feeds send a
fresh snapshot followed by incremental updates.

## Related

<CardGroup cols={2}>
  <Card title="Derivatives WebSocket guide" icon="bolt" href="/exchange/guides/futures/websockets">
    Authentication flow, subscribe/unsubscribe semantics.
  </Card>

  <Card title="Derivatives Introduction" icon="book" href="/exchange/guides/futures/introduction">
    Endpoints, protocols, and surface overview.
  </Card>

  <Card title="Derivatives REST" icon="code" href="/exchange/guides/futures/rest">
    Order entry and account-data endpoints.
  </Card>

  <Card title="Unified FIX" icon="terminal" href="/exchange/api-reference/unified-fix">
    Lowest-latency order entry across Spot + Derivatives.
  </Card>

  <Card title="Choose your protocol" icon="code-compare" href="/exchange/guides/general/api-comparison">
    REST vs WebSocket vs FIX — sequencing and cancel scope.
  </Card>
</CardGroup>