View raw: /README.md · JSON: /api/v1/feed/health · Dashboard: /

Quick start

# All live events with real Back/Lay odds
curl https://porqpine.cloud/api/v1/feed/socket-events | jq

Full event catalogue
curl https://porqpine.cloud/api/v1/feed/events | jq '.count'

In-play events only
curl https://porqpine.cloud/api/v1/feed/events/live | jq '.data | length'

Single event detail (id can be internal or bfi — the API translates)
curl https://porqpine.cloud/api/v1/feed/event/1610350 | jq

All odds for an event — match, fancy, bookmaker
curl https://porqpine.cloud/api/v1/feed/event/1610350/odds | jq

Cricket fancy markets only
curl https://porqpine.cloud/api/v1/feed/event/1610350/fancy | jq

Bulk odds for a watch list
curl -X POST https://porqpine.cloud/api/v1/feed/odds/unified \
  -H 'Content-Type: application/json' \
  -d '{"matchIds":["1610350","1607150"]}' | jq

Search by name
curl 'https://porqpine.cloud/api/v1/feed/search?q=ipl' | jq

Completed match results
curl 'https://porqpine.cloud/api/v1/feed/results?limit=10' | jq

Health probe
curl https://porqpine.cloud/api/v1/admin/health | jq

Endpoint reference

Discovery

Single event

Bulk

Completed results

Raw market frames

Reverse-proxied iframes

Health & diagnostics

Two ID schemes

{
  "id": 1610250,
  "betfair_event_id": 35575273,
  "raw": { "betfair_event_id": 35575273, ... }
}

Sample responses

GET /api/v1/feed/sports

{
  "success": true,
  "data": [
    { "name": "Football", "count": 870, "events": [{"id":1572164,"name":"..."}] },
    { "name": "Tennis", "count": 410, "events": [...] },
    { "name": "Cricket", "count": 72, "events": [...] }
  ]
}

GET /api/v1/feed/events?sport=Football

{
  "success": true,
  "count": 870,
  "data": [
    {
      "id": 1572164,
      "name": "Real Sociedad vs Betis",
      "team_a": "Real Sociedad",
      "team_b": "Betis",
      "sport": "Football",
      "status": "LIVE",
      "in_play": true,
      "betfair_event_id": 35540213,
      "competition": { "id": 12018851, "slug": "..." }
    }
  ]
}

GET /api/v1/feed/socket-events

{
  "success": true,
  "count": 139,
  "data": [
    {
      "id": 35540213,
      "bfi": 35540213,
      "name": "Real Sociedad vs Betis",
      "sport": "Football",
      "status": "In Play",
      "in_play": true,
      "markets": [{ "market_id": "1.257422429", "type": "MATCH_ODDS" }],
      "selections": [
        { "name": "Real Sociedad", "market_id": "1.257422429", "back_odds": 2.58, "back_size": 151, "lay_odds": 2.62, "lay_size": 89 },
        { "name": "Betis",         "market_id": "1.257422429", "back_odds": 3.10, "back_size":  42, "lay_odds": null, "lay_size": null }
      ]
    }
  ]
}

GET /api/v1/feed/event/:id

{
  "success": true,
  "data": {
    "event_id": "35540213",
    "internal_id": "1598914",
    "bfi": "35540213",
    "event": {
      "id": 1598914, "name": "Real Sociedad vs Betis",
      "sport": "Football", "in_play": true,
      "team_a": "Real Sociedad", "team_b": "Betis",
      "betfair_event_id": 35540213
    },
    "socket_odds": {
      "byMarketId": { "1.257422429": { / per-market frame / } },
      "byBfi":      { "35540213":    { / event-keyed frame / } }
    },
    "source": "live"
  }
}

GET /api/v1/feed/event/:id/odds (the richest endpoint)

{
  "success": true,
  "data": {
    "event_id": "1610350",
    "internal_id": "1610350",
    "bfi": "35574416",
    "market": { "byMarketId": { "1.257823308": { ... } }, "byBfi": { ... } },
    "match_odds": [
      {
        "market_id": "1.257823308",
        "market_name": "Match Odds",
        "selections": [
          {
            "name": "Delhi Capitals",
            "back": [{ "level": 1, "odds": 1.93, "size": 500000 }],
            "lay":  [{ "level": 1, "odds": 1.94, "size": 500000 }]
          },
          {
            "name": "Kolkata Knight Riders",
            "back": [{ "level": 1, "odds": 2.06, "size": 500000 }],
            "lay":  [{ "level": 1, "odds": 2.08, "size": 500000 }]
          }
        ]
      }
    ],
    "fancy":     [...],   // populated when match is imminent / in-play
    "bookmaker": [...],   // populated when in-play
    "_meta":     { "matchoddsFound": 1, "marketIds": ["1.257823308"] },
    "source": "live"
  }
}

GET /api/v1/feed/event/:id/fancy

{
  "success": true,
  "data": {
    "event_id": "1610350",
    "internal_id": "1610350",
    "bfi": "35574416",
    "markets": [
      {
        "market_id": "c5bae77612b6d55d67af728b9e2ce0f5",
        "market_name": "2 Over Runs Mitchell Starc 'DC' ADV.",
        "selections": [{
          "name": "2 Over Runs Mitchell Starc 'DC' ADV.",
          "back": [{ "level": 1, "odds": 18, "size": 100 }],
          "lay":  [{ "level": 1, "odds": 16, "size": 100 }]
        }]
      }
    ],
    "count": 90,
    "source": "live",
    "best": [...]
  }
}

GET /api/v1/feed/event/:id/bookmaker

{
  "success": true,
  "data": {
    "event_id": "1610350",
    "skeleton": [
      { "market_id": "98d947a9...", "market_name": "Bookmaker 0 Commission", "selection_ids": ["47068057","47068058"] },
      { "market_id": "7e2a1f03...", "market_name": "To Win The Toss",       "selection_ids": ["47068059","47068060"] }
    ],
    "markets": [...],
    "count": 0,
    "source": "skeleton"
  }
}

GET /api/v1/feed/event/:id/scorecard (proxied iframe)

{
  "success": true,
  "data": {
    "event_id": "1610386",
    "scorecard_url":          "https://porqpine.cloud/proxy/scorecard/<hash>/<channel>",
    "iframe_html":            "<iframe src='https://porqpine.cloud/proxy/scorecard/<hash>/<channel>' width='100%' height='245px' frameborder='0'></iframe>",
    "channel_id": "1234",
    "hash": "8031746d39afeab07af7ce8351ab56d30d27cd50"
  }
}

GET /api/v1/feed/event/:id/stream

{
  "success": true,
  "data": {
    "event_id": "1598914",
    "team_a": "Real Sociedad",
    "team_b": "Betis",
    "streams": [
      {
        "type": "tracker",
        "url":         "https://porqpine.cloud/proxy/tracker/12562643?productName=v33-1-dark",
        "iframe_html": "<iframe src='https://porqpine.cloud/proxy/tracker/12562643?productName=v33-1-dark' width='100%' height='300px' frameborder='0'></iframe>"
      },
      {
        "type": "scorecard",
        "url":         "https://porqpine.cloud/proxy/scorecard/<hash>/<channel>"
      },
      { "type": "hls", "url": "https://.../stream.m3u8" }
    ]
  }
}

POST /api/v1/feed/odds/unified

curl -X POST https://porqpine.cloud/api/v1/feed/odds/unified \
  -H 'Content-Type: application/json' \
  -d '{"matchIds":["1610250","1598914"]}'

{
  "success": true,
  "data": {
    "match_ids": ["1610250","1598914"],
    "market": {
      "1610250": { "internal_id":"1610250", "bfi":"35575273", "market":{"byMarketId":{...}}, "fancy":null, "bookmaker":null },
      "1598914": { "internal_id":"1598914", "bfi":"35540213", "market":{...}, ... }
    },
    "source": "live"
  }
}

GET /api/v1/feed/results

{
  "success": true,
  "count": 50,
  "totals": { "saved": 12, "rest": 38 },
  "data": [
    {
      "internal_id": "1610350",
      "bfi": "35574416",
      "name": "Delhi Capitals vs Kolkata Knight Riders",
      "sport": "Cricket",
      "team_a": "Delhi Capitals",
      "team_b": "Kolkata Knight Riders",
      "completed_at": "2026-05-08T23:54:18.022Z",
      "winner": "Kolkata Knight Riders",
      "final_match_odds": { "1.257823308": { / last-seen frame / } },
      "final_scores":     { / last-seen score frame / }
    }
  ]
}

GET /api/v1/feed/result/:id

curl https://porqpine.cloud/api/v1/feed/result/1610350
curl https://porqpine.cloud/api/v1/feed/result/35574416   # bfi works too

GET /api/v1/admin/health

{
  "success": true,
  "data": {
    "status": "ok", "version": "2.0.0", "uptime_s": 168,
    "memory":  { "rss_mb": 139, "heapUsed_mb": 24 },
    "cache":   { "entries": 700 },
    "socket":  { "connected": true, "rooms_subscribed": { "matchOdds": 7, "fancy": 7, "bookmaker": 7 } },
    "accounts":{ "total": 4, "active": 4 },
    "ws_clients": 3,
    "result_saver": { "total": 6, "snapshots": { "events_tracked": 1760 } }
  }
}

WebSocket protocol

const ws = new WebSocket('wss://porqpine.cloud/ws');

ws.onopen = () => {
  ws.send(JSON.stringify({ action: 'subscribe', room: 'all' }));
  // Or scope by event / market:
  // ws.send(JSON.stringify({ action: 'subscribe', room: 'event:1610250' }));
  // ws.send(JSON.stringify({ action: 'subscribe', room: 'market:1.257422429' }));
};

ws.onmessage = (e) => {
  const msg = JSON.parse(e.data);
  switch (msg.type) {
    case 'connected':              break;  // clientId, stats
    case 'market_odds':            break;  // msg.marketId, msg.data
    case 'match_odds':             break;  // msg.bfi, msg.data
    case 'event_scores':           break;  // msg.data.event_id
    case 'fancy_update':           break;  // msg.matchId, msg.data
    case 'bookmaker_add':          break;  // msg.matchId, msg.marketId, msg.data
    case 'bookmaker_remove':       break;
    case 'matches_updated':        break;  // full match list (every 30s)
    case 'remove_match_from_list': break;  // match settled
  }
};

Client → Server actions

Code samples

JavaScript — leaderboard of live events

const r = await fetch('https://porqpine.cloud/api/v1/feed/socket-events');
const { data } = await r.json();
data.forEach(ev => {
  const main = ev.markets.find(m => m.type === 'MATCH_ODDS');
  const sels = ev.selections.filter(s => s.market_id === main?.market_id);
  console.log(${ev.sport.padEnd(12)} ${ev.name});
  sels.forEach(s => console.log(   ${s.name.padEnd(28)} back ${s.back_odds ?? '-'}  lay ${s.lay_odds ?? '-'}));
});

Python — refresh odds for a watch list

import requests
ids = ["1610250", "1598914", "1607150"]
r = requests.post(
    "https://porqpine.cloud/api/v1/feed/odds/unified",
    json={"matchIds": ids},
    timeout=30,
)
payload = r.json()["data"]
for mid in ids:
    bucket = payload["market"].get(mid) or {}
    n = len((bucket.get("market") or {}).get("byMarketId", {}))
    print(mid, bucket.get("internal_id"), bucket.get("bfi"), n, "markets")

Node — live odds via WebSocket for one event

import WebSocket from 'ws';
const ws = new WebSocket('wss://porqpine.cloud/ws');
ws.on('open', () => {
  ws.send(JSON.stringify({ action: 'subscribe', room: 'event:1610250' }));
  // Engage the live feed for this event:
  fetch('https://porqpine.cloud/api/v1/feed/event/1610250/odds').catch(() => {});
});
ws.on('message', buf => {
  const msg = JSON.parse(buf.toString());
  if (msg.type === 'market_odds')  console.log(msg.marketId, msg.data.BF?.SL?.[0]);
  if (msg.type === 'event_scores') console.log('score', msg.data);
});

curl — embed a scorecard

URL=$(curl -s 'https://porqpine.cloud/api/v1/feed/event/35574416/scorecard' | jq -r '.data.scorecard_url')
echo "<iframe src=\"$URL\" width=\"100%\" height=\"245\" frameborder=\"0\"></iframe>"

Caching, polling, freshness

Caveats

• Fancy availability depends on time-to-match. A typical IPL fixture exposes ~90 fancy markets when the match is same-day or in-play; fixtures 2+ days out usually have 0. The API hides this difference behind the count and source fields.

• Bookmaker rows are typically empty pre-match. The skeleton field still lists the available bookmaker markets so your UI can render the structure even before prices flow.

• lay_odds: null in /socket-events is normal for a thin lay book at that snapshot moment.

• Sport labels — filter case-insensitively. The API normalises capitalisation on the way out, but be lenient on input.

Status codes

Versioning & stability

License