Live odds and results for your sportsbook, as they move.

# Your key goes in a header, never in the URL.
export DIAMONDAPI_KEY="fg_test_…"
export BASE="https://api-sandbox.diamondapi.live"

curl -s -H "X-API-Key: $DIAMONDAPI_KEY" "$BASE/v1/me"
curl -s --compressed -H "X-API-Key: $DIAMONDAPI_KEY" "$BASE/v1/events?sport=cricket&state=inplay"

# A live stream: one connection, kept open. Sandbox keys list up to 5 event ids;
# a live key may use events=all.
curl -N -H "X-API-Key: $DIAMONDAPI_KEY" "$BASE/v1/stream?events=ev_k9wtucdybikxygkh,ev_zizcp33rpuucwacg"

// Node 18+ or any modern runtime. The key stays on your server.
const BASE = 'https://api-sandbox.diamondapi.live'
const headers = { 'X-API-Key': process.env.DIAMONDAPI_KEY }

const me = await (await fetch(BASE + '/v1/me', { headers })).json()
console.log(me.client, me.sports)

const { events } = await (await fetch(BASE + '/v1/events?state=inplay', { headers })).json()
const event = await (await fetch(BASE + '/v1/events/' + events[0].id, { headers })).json()
console.log(event.name, event.markets.length, 'markets')

import os, requests

BASE = "https://api-sandbox.diamondapi.live"
s = requests.Session()
s.headers["X-API-Key"] = os.environ["DIAMONDAPI_KEY"]

print(s.get(BASE + "/v1/me").json())
events = s.get(BASE + "/v1/events", params={"state": "inplay"}).json()["events"]
event = s.get(BASE + "/v1/events/" + events[0]["id"]).json()
print(event["name"], len(event["markets"]), "markets")

{
  "client": "Acme Sportsbook",
  "sports": ["cricket", "soccer", "tennis"],
  "limits": { "maxStreams": 5, "minPollMs": 1000, "maxEventsPerStream": 0, "delayMs": 0 },
  "serverTime": "2026-11-09T21:08:31Z"
}

{
  "sports": [
    { "sport": "cricket", "events": 17, "inplay": 3, "upcoming": 14 },
    { "sport": "soccer",  "events": 99, "inplay": 17, "upcoming": 82 },
    { "sport": "tennis",  "events": 143, "inplay": 11, "upcoming": 132 }
  ]
}

{
  "competitions": [
    { "id": "cp_uumfx68hmdwne54u", "name": "One Day Internationals", "sport": "cricket", "events": 2 },
    { "id": "cp_snvzngyxyb44tc94", "name": "South Africa T20 Challenge", "sport": "cricket", "events": 3 }
  ]
}

{
  "events": [
    {
      "id": "ev_k9wtucdybikxygkh",
      "name": "Pakistan v Sri Lanka",
      "sport": "cricket",
      "competition": { "id": "cp_uumfx68hmdwne54u", "name": "One Day Internationals" },
      "start": "2026-11-09T04:30:00Z",
      "state": "inplay",
      "inplay": true,
      "updatedAt": 1794258468524,
      "marketCount": 41
    }
  ]
}

{
  "id": "ev_k9wtucdybikxygkh",
  "name": "Pakistan v Sri Lanka",
  "sport": "cricket",
  "competition": { "id": "cp_uumfx68hmdwne54u", "name": "One Day Internationals" },
  "start": "2026-11-09T04:30:00Z",
  "state": "inplay",
  "inplay": true,
  "updatedAt": 1794258468524,
  "markets": [
    {
      "id": "mk_vf86825bva46g3qq", "name": "Match Odds",
      "type": "match_odds", "format": "decimal", "status": "OPEN", "inplay": true,
      "updatedAt": 1794258468524,
      "runners": [
        { "id": "rn_svsqaaiuqdfnetsf", "name": "Pakistan", "status": "OPEN",
          "back": [{ "price": 1.49, "size": 1525.4 }, { "price": 1.48, "size": 980 }],
          "lay":  [{ "price": 1.52, "size": 640.1 }] },
        { "id": "rn_jz7r79c78pm4y3dp", "name": "Sri Lanka", "status": "OPEN",
          "back": [{ "price": 2.88, "size": 257.53 }],
          "lay":  [{ "price": 3, "size": 25 }] }
      ]
    },
    {
      "id": "mk_3hb7tq2wc9xzv5ne", "name": "Bookmaker",
      "type": "bookmaker", "format": "rate", "status": "OPEN",
      "runners": [
        { "id": "rn_q3m8x2wte6kd7bpa", "name": "Pakistan", "status": "OPEN",
          "back": [{ "price": 48, "size": 100000 }], "lay": [{ "price": 52, "size": 100000 }] }
      ]
    },
    {
      "id": "mk_juc56fmwfmqx7gag", "name": "10 over run PAK",
      "type": "fancy", "format": "line", "status": "BALL_RUNNING",
      "runners": [
        { "id": "rn_p8vd2hsn4c6xqe9w", "name": "10 over run PAK", "status": "OPEN",
          "back": [{ "price": 61, "size": 90 }], "lay": [{ "price": 61, "size": 110 }] }
      ]
    }
  ]
}

{
  "events":  [ { "id": "ev_k9wtucdybikxygkh", "name": "Pakistan v Sri Lanka", "markets": [ … ] } ],
  "missing": ["ev_zizcp33rpuucwacg"],
  "next":    "9f2c41d0.18342"
}

// npm install eventsource
import { EventSource } from 'eventsource'

const book = new Map()           // event id -> event, kept current
const es = new EventSource('https://api-sandbox.diamondapi.live/v1/stream?events=all', {
  fetch: (url, init) => fetch(url, { ...init, headers: { ...init.headers, 'X-API-Key': process.env.DIAMONDAPI_KEY } }),
})

es.addEventListener('snapshot', (m) => { const ev = JSON.parse(m.data); book.set(ev.id, ev) })
es.addEventListener('market-update', (m) => {
  const { event, market } = JSON.parse(m.data)
  const ev = book.get(event); if (!ev) return
  const i = ev.markets.findIndex((x) => x.id === market.id)
  i >= 0 ? (ev.markets[i] = market) : ev.markets.push(market)
})
es.addEventListener('market-remove', (m) => {
  const { event, market } = JSON.parse(m.data)
  const ev = book.get(event); if (ev) ev.markets = ev.markets.filter((x) => x.id !== market)
})
es.addEventListener('event-remove', (m) => book.delete(JSON.parse(m.data).id))
es.addEventListener('result', (m) => settle(JSON.parse(m.data)))   // your settlement
// EventSource reconnects by itself and sends Last-Event-ID.

# pip install requests sseclient-py
import json, os, requests, sseclient

url = "https://api-sandbox.diamondapi.live/v1/stream?events=all"
headers = {"X-API-Key": os.environ["DIAMONDAPI_KEY"], "Accept": "text/event-stream"}
last_id = None
book = {}

while True:
    if last_id: headers["Last-Event-ID"] = last_id
    resp = requests.get(url, headers=headers, stream=True, timeout=(10, 45))
    try:
        for m in sseclient.SSEClient(resp).events():
            last_id = m.id or last_id
            data = json.loads(m.data)
            if m.event == "snapshot": book[data["id"]] = data
            elif m.event == "market-update": upsert(book, data["event"], data["market"])
            elif m.event == "event-remove": book.pop(data["id"], None)
            elif m.event == "result": settle(data)
    except requests.RequestException:
        pass  # reconnect with Last-Event-ID

event: snapshot
id: 9f2c41d0.18342.17493
data: {"id":"ev_k9wtucdybikxygkh","name":"Pakistan v Sri Lanka","sport":"cricket", … ,"markets":[…]}

event: ready
id: 9f2c41d0.18342.17493
data: {"events":1}

event: market-update
id: 9f2c41d0.18347.17493
data: {"event":"ev_k9wtucdybikxygkh","market":{"id":"mk_vf86825bva46g3qq","name":"Match Odds","type":"match_odds","format":"decimal","status":"OPEN", … }}

: heartbeat

event: market-remove
id: 9f2c41d0.18390.17493
data: {"event":"ev_k9wtucdybikxygkh","market":"mk_juc56fmwfmqx7gag"}

event: result
id: 9f2c41d0.18390.17494
data: {"seq":17494,"action":"SETTLED","sport":"cricket","market":{"id":"mk_juc56fmwfmqx7gag","name":"10 over run PAK","type":"fancy"},"result":64, … }

{
  "changes": [
    { "type": "market-update", "data": { "event": "ev_k9wtucdybikxygkh", "market": { "id": "mk_vf86825bva46g3qq", … } } },
    { "type": "event-remove",  "data": { "id": "ev_qfsu3ku7736ttn69" } }
  ],
  "next": "9f2c41d0.18390"
}

{
  "seq": 17327,
  "action": "SETTLED",
  "sport": "cricket",
  "event":  { "id": "ev_k9wtucdybikxygkh", "name": "Pakistan v Sri Lanka", "start": "2026-11-09T04:30:00Z" },
  "market": { "id": "mk_ywxwfni42227wbyh", "name": "To Win The Toss", "type": "bookmaker" },
  "winner": { "id": "rn_jz7r79c78pm4y3dp", "name": "Sri Lanka" },
  "settledAt": "2026-11-09T04:23:43Z",
  "at": "2026-11-09T04:23:45Z"
}

{
  "results": [ { "seq": 17326, … }, { "seq": 17327, … } ],
  "next": 17327,
  "more": false
}

{
  "market": { "id": "mk_r4nd8w2qk6t3pyvh", "name": "29.3 over run NZ", "type": "fancy" },
  "event":  { "id": "ev_zizcp33rpuucwacg", "name": "New Zealand v India" },
  "status": "SETTLED",
  "result": 91,
  "settledAt": "2026-11-07T05:27:16Z",
  "seq": 17001,
  "corrected": false
}

{
  "event": "ev_k9wtucdybikxygkh",
  "markets": [
    { "market": { "id": "mk_ywxwfni42227wbyh", "name": "To Win The Toss", "type": "bookmaker" },
      "status": "SETTLED", "winner": { "id": "rn_jz7r79c78pm4y3dp", "name": "Sri Lanka" }, … },
    { "market": { "id": "mk_vf86825bva46g3qq", "name": "Match Odds", "type": "match_odds" },
      "status": "PENDING", "corrected": false }
  ]
}

X-Quota-Remaining: requests-today=187234; stream-minutes-month=118400

{ "code": "forbidden", "message": "request IP is not on this client's allowlist" }