Skip to main content

1. Get your API key

Sign up at therundown.io/api to get your API key.

2. Make your first request

curl "https://therundown.io/api/v2/sports?key=YOUR_API_KEY"
You’ll receive a list of all available sports with their IDs:
{
  "sports": [
    { "sport_id": 1, "sport_name": "NCAAF" },
    { "sport_id": 2, "sport_name": "NFL" },
    { "sport_id": 3, "sport_name": "MLB" },
    { "sport_id": 4, "sport_name": "NBA" },
    { "sport_id": 5, "sport_name": "NCAAB" },
    { "sport_id": 6, "sport_name": "NHL" }
  ]
}

3. Get today’s NBA odds

curl "https://therundown.io/api/v2/sports/4/events/2026-02-12?key=YOUR_API_KEY&market_ids=1,2,3"

4. Get real-time updates via WebSocket

const ws = new WebSocket(
  "wss://therundown.io/api/v2/ws/markets?key=YOUR_API_KEY&sport_ids=4"
);

ws.onmessage = (event) => {
  const data = JSON.parse(event.data);
  if (data.meta?.type === "heartbeat") return;
  console.log("Price update:", data);
};

Next steps