# Stream Events
URL: https://sockodds.com/docs/endpoints/streamEvents/

# Stream Events [#stream-events]

Setup streamed (WebSocket) connection

`GET https://api.sockodds.com/v2/stream/events`

Reserved. SockOdds does not stream: the source refreshes every ~2 minutes and this endpoint answers 501 so a client written for SportsGameOdds fails loudly instead of waiting on a socket that never opens.

## Query parameters [#query-parameters]

| Parameter | Type | Description |
| --- | --- | --- |
| `feed` | `string` | The feed you would like to subscribe to (events:live, events:upcoming, events:byid) |
| `leagueID` | `string` | A leagueID to stream events for |
| `eventID` | `string` | An eventID to stream events for |

## Response [#response]

`{ "success": true, "data": StreamEventsPusherResponse[], "nextCursor": string | null }`

### Status codes [#status-codes]

| Status | Body |
| --- | --- |
| `501` | `{"success":false,"error":"Not Implemented"}` |

## Code samples [#code-samples]

**cURL** · **JavaScript** · **Python** · **Go** · **Java** · **C#**

```bash
curl -X GET "https://api.sockodds.com/v2/stream/events?feed=events:live" \
  -H "x-api-key: YOUR_API_KEY"
```

```javascript
const r = await fetch("https://api.sockodds.com/v2/stream/events?feed=events:live", { headers: { "x-api-key": "YOUR_API_KEY" } });
const { success, data, nextCursor, notice } = await r.json();
```

```python
import requests
r = requests.get("https://api.sockodds.com/v2/stream/events", params=dict(feed="events:live"), headers={"x-api-key": "YOUR_API_KEY"})
body = r.json()
```

```go
req, _ := http.NewRequest("GET", "https://api.sockodds.com/v2/stream/events?feed=events:live", nil)
req.Header.Set("x-api-key", "YOUR_API_KEY")
res, err := http.DefaultClient.Do(req)
```

```java
HttpRequest req = HttpRequest.newBuilder().uri(URI.create("https://api.sockodds.com/v2/stream/events?feed=events:live"))
    .header("x-api-key", "YOUR_API_KEY").GET().build();
HttpResponse<String> res = HttpClient.newHttpClient().send(req, HttpResponse.BodyHandlers.ofString());
```

```csharp
using var http = new HttpClient();
http.DefaultRequestHeaders.Add("x-api-key", "YOUR_API_KEY");
var body = await http.GetStringAsync("https://api.sockodds.com/v2/stream/events?feed=events:live");
```

> Need help?[FAQ](https://sockodds.com/docs/faq/) · [Email](mailto:api@sockodds.com) · [Contact](https://sockodds.com/contact-us/)