Quickstart

You need an API key (efk_…). Send it as a bearer token.

1. List live events

curl https://api.eventsfeed.dev/v1/events \
  -H "Authorization: Bearer $EVENTSFEED_KEY"
{
  "data": [
    {
      "id": "ev_k2m9x4q8zt",
      "sport": "soccer",
      "competition": { "id": "cp_3nfp8e2kx1", "name": "England Premier League" },
      "home": { "id": "tm_7d1qv0wz3e", "name": "Arsenal", "colors": ["#EF0107", "#FFFFFF"] },
      "away": { "id": "tm_0p4hc9m2ra", "name": "Chelsea" },
      "startsAt": "2026-11-15T19:00:00.000Z",
      "state": "live",
      "phase": "2H",
      "clock": { "seconds": 4080, "running": true, "display": "68'" },
      "score": { "home": 2, "away": 1, "ht": { "home": 1, "away": 0 } },
      "channels": ["core", "odds", "stats"],
      "updatedAt": "2026-11-15T20:08:01.512Z"
    }
  ],
  "meta": { "ts": "2026-11-15T20:08:01.700Z", "requestId": "4c5c…", "rev": 18342 }
}

2. Get odds for one event

curl https://api.eventsfeed.dev/v1/events/ev_k2m9x4q8zt/odds \
  -H "Authorization: Bearer $EVENTSFEED_KEY"
{
  "data": {
    "markets": {
      "match_result.ft": { "key": "match_result", "period": "FT", "status": "open",
                           "selections": { "home": 1.85, "draw": 3.4, "away": 4.2 } },
      "[email protected]": { "key": "total_goals", "period": "FT", "line": 2.5, "status": "suspended",
                              "suspendReason": "line_settled", "selections": { "over": 1.5, "under": 2.5 } }
    }
  },
  "meta": { "ts": "…", "requestId": "…", "rev": 912 }
}

Tip: GET /v1/events?include=odds,stats returns everything for all live events in one request.

3. Stream changes (JavaScript)

import WebSocket from 'ws'; // browsers: the built-in WebSocket, with ?key=

const ws = new WebSocket('wss://api.eventsfeed.dev/v1/stream', {
  headers: { Authorization: `Bearer ${process.env.EVENTSFEED_KEY}` },
});
const state = {};             // topic -> current value
const rev = {};               // topic -> last revision

ws.on('open', () => ws.send(JSON.stringify({ op: 'sub', topics: ['live', 'ev_k2m9x4q8zt:*'] })));
ws.on('message', raw => {
  const f = JSON.parse(raw);
  if (f.t === 'snap') state[f.topic] = f.d;
  else if (f.t === 'patch') state[f.topic] = mergePatch(state[f.topic], f.d);
  else return;
  rev[f.topic] = f.rev;
  console.log(f.topic, f.rev);
});

function mergePatch(target, patch) {          // RFC 7386
  if (patch === null || typeof patch !== 'object' || Array.isArray(patch)) return patch;
  const out = target && typeof target === 'object' && !Array.isArray(target) ? { ...target } : {};
  for (const [k, v] of Object.entries(patch)) v === null ? delete out[k] : (out[k] = mergePatch(out[k], v));
  return out;
}

3b. Python

import asyncio, json, os, websockets   # pip install websockets

def merge_patch(target, patch):
    if not isinstance(patch, dict):
        return patch
    out = dict(target) if isinstance(target, dict) else {}
    for k, v in patch.items():
        if v is None: out.pop(k, None)
        else: out[k] = merge_patch(out.get(k), v)
    return out

async def main():
    url = "wss://api.eventsfeed.dev/v1/stream?key=" + os.environ["EVENTSFEED_KEY"]
    state = {}
    async with websockets.connect(url) as ws:
        await ws.send(json.dumps({"op": "sub", "topics": ["live"]}))
        async for raw in ws:
            f = json.loads(raw)
            if f["t"] == "snap":  state[f["topic"]] = f["d"]
            elif f["t"] == "patch": state[f["topic"]] = merge_patch(state.get(f["topic"]), f["d"])
            if f["t"] in ("snap", "patch"):
                print(f["topic"], f["rev"], len(state["live"] or {}), "live events")

asyncio.run(main())

Next: WebSocket protocol · Data model.