Multiplexed WebSocket — subscribe to markets, scores, plays, and live channels

curl --request GET \
  --url 'https://therundown.io/api/v2/ws?key='

import requests

url = "https://therundown.io/api/v2/ws?key="

response = requests.get(url)

print(response.text)

const options = {method: 'GET'};

fetch('https://therundown.io/api/v2/ws?key=', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://therundown.io/api/v2/ws?key=",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://therundown.io/api/v2/ws?key="

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://therundown.io/api/v2/ws?key=")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://therundown.io/api/v2/ws?key=")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

V2 WebSocket

Multiplexed WebSocket — subscribe to markets, scores, plays, and live channels

Establishes a single WebSocket connection carrying multiple logical channels. Instead of query-parameter filters, send JSON subscribe messages after connecting.

Connection: wss://therundown.io/api/v2/ws?key=YOUR_API_KEY

Channels:

markets — market price updates (same payloads as /api/v2/ws/markets)
scores — score and event-status updates (no live game state fields)
plays — play-by-play deltas for live games. Requires an Ultra plan or higher (the live game state entitlement); a plays or live subscribe from a non-entitled key is rejected with error code forbidden.
live — score/status deltas including live_game_state, plus play-by-play deltas, on one subscription. Requires an Ultra plan or higher; live_game_state and game_state are accepted aliases.

Subscribe (client → server):

{
  "action": "subscribe",
  "id": "p1",
  "channel": "plays",
  "params": { "sport_ids": [3], "event_ids": ["<eventID>"] }
}

The server acknowledges with {"type":"subscribed","id":"p1","sequence":N,"message":"subscribed to plays"}. Supported params filters: sport_ids, event_ids (plus market_ids and affiliate_ids on the markets channel). Unsubscribe with {"action":"unsubscribe","id":"p1"}.

Delta messages (server → client) are wrapped in an envelope tagged with your subscription id:

{
  "type": "delta",
  "id": "p1",
  "sequence": 42,
  "sub_sequence": 7,
  "delta_last_id": "...",
  "data": { "meta": { "type": "play" }, "data": { ... } }
}

Snapshots: add "snapshot": true to params to receive current state (snapshot frames, then snapshot_complete) before deltas begin; an active subscription can request a fresh snapshot at any time with {"action":"snapshot","id":"p1"}. Snapshot requests need a bounded scope and are metered as data points like the equivalent REST reads.

Errors: {"type":"error","id":"...","code":"...","message":"..."} with codes forbidden (plays/live without Ultra+), invalid_channel, missing_id, duplicate_id, and subscription_limit (plan’s concurrent subscription cap reached).

Concurrent connection and subscription limits vary by tier. See the WebSocket reference for full protocol details.

GET

api

Multiplexed WebSocket — subscribe to markets, scores, plays, and live channels

curl --request GET \
  --url 'https://therundown.io/api/v2/ws?key='

import requests

url = "https://therundown.io/api/v2/ws?key="

response = requests.get(url)

print(response.text)

const options = {method: 'GET'};

fetch('https://therundown.io/api/v2/ws?key=', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://therundown.io/api/v2/ws?key=",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://therundown.io/api/v2/ws?key="

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://therundown.io/api/v2/ws?key=")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://therundown.io/api/v2/ws?key=")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

Authorizations

key

string

query

required

API key as query parameter

Response

101

WebSocket upgrade successful

Markets WebSocket — stream real-time market price updates Get a single event with lines

⌘I

V2 Sports

V2 Events

V2 Markets

V2 Teams

V2 Players

V2 Stats

V2 Reference

V2 WebSocket

V1 Events (Legacy)

V1 Lines (Legacy)

V1 Sports (Legacy)

V1 Delta (Legacy)

V1 Reference (Legacy)

V1 WebSocket (Legacy)

Multiplexed WebSocket — subscribe to markets, scores, plays, and live channels

Authorizations

Response