Futures & Outrights

{
  "event_id": "a3d1f9f94f220a45cfd944181569cc46",
  "sport_id": 2,
  "event_date": "2026-09-10T00:00:00Z",
  "settle_by": "2027-02-21T00:00:00Z",
  "event_status": "STATUS_SCHEDULED",
  "settlement": {},
  "schedule": {
    "event_name": "NFL Super Bowl Winner (2026 Season)",
    "season_year": 2026
  },
  "markets": [
    {
      "id": 4967891,
      "market_id": 1141,
      "period_id": 0,
      "name": "tournament_winner",
      "market_description": "Tournament Winner",
      "participants": [
        {
          "id": 61,
          "type": "TYPE_TEAM",
          "name": "Buffalo Bills",
          "lines": [
            {
              "id": "8155509548895b87157633c87df81b3e",
              "prices": {
                "22": { "id": "665502535", "price": 1000, "is_main_line": true, "updated_at": "2026-07-29T17:01:46Z" },
                "25": { "id": "665857721", "price": 1074, "is_main_line": true, "updated_at": "2026-07-29T18:30:25Z" }
              }
            }
          ]
        }
      ]
    }
  ]
}

curl "https://therundown.io/api/v2/sports/2/futures?key=YOUR_API_KEY&affiliate_ids=22,25"

import requests

resp = requests.get(
    "https://therundown.io/api/v2/sports/2/futures",
    headers={"X-TheRundown-Key": "YOUR_API_KEY"},
    params={"affiliate_ids": "22,25"},
)

for event in resp.json()["events"]:
    print(event["schedule"]["event_name"])
    for market in event["markets"]:
        print(f"  {market['market_description']} (market {market['market_id']})")
        for p in market["participants"]:
            prices = p["lines"][0]["prices"]
            quotes = ", ".join(
                f"book {aff}: {q['price']:+}" for aff, q in sorted(prices.items())
            )
            print(f"    {p['name']}: {quotes}")

def fetch_all_futures(sport_id, **params):
    events, cursor = [], None
    while True:
        if cursor:
            params["cursor"] = cursor
        resp = requests.get(
            f"https://therundown.io/api/v2/sports/{sport_id}/futures",
            headers={"X-TheRundown-Key": "YOUR_API_KEY"},
            params=params,
        )
        data = resp.json()
        events.extend(data["events"])
        cursor = data.get("meta", {}).get("next_cursor")
        if not cursor:
            return events

{
  "id": 1595215220,
  "event_id": "7685a32da628c77e031a2d9701128882",
  "sport_id": 40,
  "affiliate_id": 19,
  "market_id": 1141,
  "market_name": "tournament_winner",
  "participant_id": 139667,
  "participant_type": "TYPE_TEAM",
  "participant_name": "Stephan Jaeger",
  "line": "",
  "price": "8000.0000",
  "previous_price": "7800.0000",
  "change_type": "price_change",
  "updated_at": "2026-08-01T14:39:44Z",
  "is_main_line": true
}

import requests
import time

API_KEY = "YOUR_API_KEY"
BASE = "https://therundown.io/api/v2"
SPORT_ID = 40           # Golf
FUTURES_MARKET_IDS = "1141"

boards = {}             # event_id -> event

def snapshot():
    """Load all futures boards and return the delta cursor."""
    cursor = None
    watermark = None
    while True:
        params = {"market_ids": FUTURES_MARKET_IDS}
        if cursor:
            params["cursor"] = cursor
        resp = requests.get(
            f"{BASE}/sports/{SPORT_ID}/futures",
            headers={"X-TheRundown-Key": API_KEY},
            params=params,
        )
        data = resp.json()
        for event in data["events"]:
            boards[event["event_id"]] = event
        watermark = data["meta"]["delta_last_id"]
        cursor = data["meta"].get("next_cursor")
        if not cursor:
            print(f"Loaded {len(boards)} boards, watermark={watermark}")
            return watermark

def poll(last_id):
    """Apply futures price changes since last_id. Returns the new cursor."""
    resp = requests.get(
        f"{BASE}/markets/delta",
        headers={"X-TheRundown-Key": API_KEY},
        params={"last_id": last_id, "market_ids": FUTURES_MARKET_IDS},
    )
    if resp.status_code != 200:
        return None                     # stale cursor -> re-snapshot
    data = resp.json()
    for d in data.get("deltas", []):
        print(f"{d['participant_name']}: {d['previous_price']} -> {d['price']} "
              f"(book {d['affiliate_id']})")
    return data["meta"]["delta_last_id"]  # always chain, even on zero rows

cursor = snapshot()
while True:
    time.sleep(30)
    cursor = poll(cursor) or snapshot()

{
  "action": "subscribe",
  "id": "golf-futures",
  "channel": "futures",
  "params": { "sport_ids": [40], "market_ids": [1141], "snapshot": true }
}

{
  "event_id": "f322ba0f4c5993c1f827a1e1b8dbae60",
  "sport_id": 40,
  "event_date": "2026-07-23T04:00:00Z",
  "settle_by": "2026-07-26T04:00:00Z",
  "event_status": "STATUS_FINAL",
  "settlement": {
    "1141": {
      "status": "settled",
      "winning_line": "Jackson Koivun",
      "winning_participant_id": 139644,
      "settled_at": "2026-07-29T02:37:50Z"
    },
    "1392": { "status": "settled", "settled_at": "2026-07-30T01:41:54Z" },
    "1393": { "status": "settled", "settled_at": "2026-07-30T01:41:54Z" },
    "1394": { "status": "settled", "settled_at": "2026-07-30T01:41:54Z" },
    "1395": { "status": "settled", "settled_at": "2026-07-30T01:41:54Z" },
    "1396": { "status": "settled", "settled_at": "2026-07-30T01:41:54Z" }
  },
  "schedule": {
    "event_name": "3M Open",
    "season_year": 2026,
    "league_name": "PGA Tour"
  }
}

curl "https://therundown.io/api/v2/sports/40/futures/f322ba0f4c5993c1f827a1e1b8dbae60?key=YOUR_API_KEY"

{
  "kind": "stroke_play_leaderboard",
  "as_of": "2026-07-25T18:42:00Z",
  "phase": { "status": "STATUS_IN_PROGRESS", "label": "Round 3 of 4", "unit": "round", "current": 3, "total": 4 },
  "context": { "...": "kind-specific" },
  "entries": [ { "...": "kind-specific, ranked" } ]
}

{
  "progress": {
    "kind": "stroke_play_leaderboard",
    "as_of": "2026-07-25T18:42:00Z",
    "phase": { "status": "STATUS_IN_PROGRESS", "label": "Round 3 of 4", "unit": "round", "current": 3, "total": 4 },
    "context": { "cut_score": -4, "cut_count": 68, "purse": 8400000, "round": 3, "round_state": "in_progress" },
    "entries": [
      { "participant_id": 139644, "name": "Jackson Koivun", "position": "1", "tied": false, "score_to_par": -14, "today": -4, "thru": 12, "movement": 1, "country": "USA", "total_strokes": 199, "round_state": "active" },
      { "participant_id": 139667, "name": "Stephan Jaeger", "position": "2", "tied": false, "score_to_par": -12, "today": -2, "thru": 14, "movement": -1, "country": "GER", "total_strokes": 201, "round_state": "active" }
    ]
  }
}

{
  "progress": {
    "kind": "league_standings",
    "as_of": "2026-08-07T09:05:00Z",
    "phase": { "status": "STATUS_IN_PROGRESS", "label": "Week 14", "unit": "week", "current": 14, "total": 18 },
    "context": {},
    "entries": [
      { "participant_id": 61, "name": "Buffalo Bills", "rank": 1, "wins": 10, "losses": 3, "ties": 0, "win_pct": 0.769, "points": 0, "conference": "AFC", "division": "AFC East", "seed": 1, "streak": "W3" },
      { "participant_id": 63, "name": "New England Patriots", "rank": 3, "wins": 7, "losses": 6, "ties": 0, "win_pct": 0.538, "points": 0, "conference": "AFC", "division": "AFC East", "seed": 6, "streak": "L1" }
    ]
  }
}

{
  "stat": "Total Yards",
  "stat_id": 1120,
  "season_year": 2025,
  "entries": [
    { "participant_id": 61, "name": "Buffalo Bills", "value": 6432, "rank": 1 },
    { "participant_id": 63, "name": "New England Patriots", "value": 5211, "rank": 2 }
  ]
}

{
  "player_leaders": [
    {
      "stat": "Passing Yards",
      "stat_id": 1101,
      "season_year": 2025,
      "entries": [
        { "participant_id": 15847, "name": "Josh Allen", "value": 4306, "rank": 1 }
      ]
    }
  ]
}