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.