---
title: "Server-Sent Events stream (Pro+): auction_published + heartbeats"
method: GET
path: "/v1/stream"
---

# Server-Sent Events stream (Pro+): auction_published + heartbeats

`GET /v1/stream`

## Request

- Base URL: `https://voltcast.com/api`
- URL: `https://voltcast.com/api/v1/stream`
- Auth: HTTP bearer

## Query parameters

- `zones` string
- `token` string

## Response `200`

text/event-stream. Events: hello, auction_published (zone, delivery_date, period_count, detected_at, prices_url), heartbeat every 15s. Connections are time-boxed to 20 minutes (retry hint provided) and concurrency-capped; use webhooks for reliable fan-out.

---

[API](https://skmtc.dev/voltcast/apis/voltcast-api.md) · [All operations](https://skmtc.dev/voltcast/apis/voltcast-api/llms.txt) · [OpenAPI document](https://skmtc.dev/voltcast/apis/voltcast-api/revisions/9c39e52e3eed?raw)
