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 -H "X-TheRundown-Key: YOUR_API_KEY" \
  "https://therundown.io/api/v2/sports"
Some reference endpoints are public, but authenticating from the start lets you see the same headers and behavior your production integration will use.
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

The offset parameter shifts the date boundary so a “day” aligns with the timezone you care about instead of midnight UTC. Use the offset that matches your market timezone. See the Events reference for examples.
curl -H "X-TheRundown-Key: YOUR_API_KEY" \
  "https://therundown.io/api/v2/sports/4/events/2026-02-12?market_ids=1,2,3&affiliate_ids=19,23&main_line=true&offset=300"
In production, market_ids, affiliate_ids, and main_line=true are your biggest levers for controlling payload size and data-point usage.

​
4. Choose your update path

Every plan can use delta endpoints for efficient polling: 
curl -H "X-TheRundown-Key: YOUR_API_KEY" \
  "https://therundown.io/api/v2/markets/delta?sport_id=4&market_ids=1,2,3&last_id=0"
If your key has X-Websocket-Access: true, you can also connect directly to the WebSocket feed for real-time updates: 
const ws = new WebSocket(
  "wss://therundown.io/api/v2/ws/markets?key=YOUR_API_KEY&sport_ids=4"
);

ws.onmessage = (event) => {
  const msg = JSON.parse(event.data);
  if (msg.meta?.type === "heartbeat") return;
  const d = msg.data;
  console.log(`Price update: event=${d.event_id} market=${d.market_id} price=${d.price}`);
};
WebSocket access is enabled on real-time tiers by default. If your key does not have it, use market delta polling instead.

​
Next steps

Authentication

Learn about all auth methods

Rate Limits

Understand data points and 429 responses

Building an Odds Screen

Step-by-step guide

Efficient Polling

Delta, caching, and cost control

Market IDs Reference

All market types and their IDs

WebSocket Streaming

Real-time data guide