Quickstart Guide - Connect to Odds API in Minutes - OddsPapi API

1) Connect

Gateway:

ws: wss://v5.oddspapi.io/ws

JavaScript (Node)
Python

import WebSocket from "ws";

const ws = new WebSocket("wss://v5.oddspapi.io/ws");

ws.on("open", () => {
  ws.send(JSON.stringify({ type: "login", apiKey: process.env.ODDS_API_KEY }));
});

ws.on("message", (data) => {
  const msg = JSON.parse(data.toString());
  console.log(msg.type ?? msg.channel, msg);
});

import json
import os
import websocket

def on_open(ws):
    ws.send(json.dumps({
        "type": "login",
        "apiKey": os.environ["ODDS_API_KEY"],
    }))

def on_message(ws, message):
    msg = json.loads(message)
    print(msg.get("type") or msg.get("channel"), msg)

ws = websocket.WebSocketApp(
    "wss://v5.oddspapi.io/ws",
    on_open=on_open,
    on_message=on_message,
)
ws.run_forever()

{
  "type": "login",
  "apiKey": "YOUR_API_KEY"
}

3) Understand the data model

Everything hangs off one tree — Sport → Tournament → Season → Fixture (single match) or Future (outright / prediction market), with participants, per-period scores, and players underneath:

How Fixtures Work

A fixture is one match between two participants — schedule, status, per-period scores, and the odds keyed on it.

How Futures Work

A future is an outright market on a whole season or event — league winners, elections, prediction markets (sportId 69+).

4) Pick your build

End-to-end guides for the four things clients most often build: prediction markets & exchanges, sharp-line trading & CLV, running OddsPapi as a second feed, and powering a sportsbook. Checking whether the feed carries what you need? See bookmaker coverage and market coverage.