快速入门指南 - 几分钟内连接Odds API - OddsPapi API

1) 连接

网关地址：

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, lang: "zh" }));
});

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"],
        "lang": "zh",
    }))

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()

2) 最小登录消息

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

3) 理解数据模型

一切都挂在同一棵树上 —— 运动 → 锦标赛 → 赛季 → 赛事（单场比赛）或期货（冠军 / 预测市场），下层是参与者、按赛段的比分和球员：

赛事如何运作

赛事是两个参与者之间的单场比赛 —— 日程、状态、按赛段的比分，以及以它为键的赔率。

期货如何运作

期货是针对整个赛季或事件的冠军类盘口 —— 联赛冠军、选举、预测市场（sportId 69+）。