Quickstart
Fetch upcoming events and odds from ALT Sports Data in under five minutes.
Quickstart
This guide walks through a real integration scenario end to end. In about five minutes, you will discover upcoming events for a league, pull the odds market for a specific event, and see the kind of structured data you can route into sportsbook, media, or AI workflows.
Prerequisites
- A demo or production ALT Sports Data API key (use
demo-0001to get started immediately) - Node.js 18+ or Python 3.10+ (or any HTTP client -- cURL works fine)
Step 1: List upcoming events for a league
Start by fetching upcoming BKFC (Bare Knuckle Fighting Championship) events. This is the same call a sportsbook would make to populate an event feed.
curl -s "https://api.altsportsdata.com/api/v1/public/events?sportType=bkfc&eventStatus=UPCOMING" \
-H "X-API-Key: demo-0001" | python3 -m json.toolconst response = await fetch(
"https://api.altsportsdata.com/api/v1/public/events?sportType=bkfc&eventStatus=UPCOMING",
{
headers: { "X-API-Key": "demo-0001" },
}
);
const payload = await response.json();
const firstEvent = payload.data[0];
console.log(`Event ID: ${firstEvent.id}`);
console.log(`Name: ${firstEvent.name}`);
console.log(`Status: ${firstEvent.eventStatus}`);import requests
response = requests.get(
"https://api.altsportsdata.com/api/v1/public/events",
headers={"X-API-Key": "demo-0001"},
params={
"sportType": "bkfc",
"eventStatus": "UPCOMING",
},
)
payload = response.json()
first_event = payload["data"][0]
print(f"Event ID: {first_event['id']}")
print(f"Name: {first_event['name']}")
print(f"Status: {first_event['eventStatus']}")Copy the id from the first event in the response -- you will use it in the next step.
Step 2: Get the event winner market
Now pull the eventWinner market for that event. This returns the odds for each participant, structured and ready for display or trading logic.
curl -s "https://api.altsportsdata.com/api/v1/public/events/YOUR_EVENT_ID/eventWinner" \
-H "X-API-Key: demo-0001" | python3 -m json.toolconst eventId = "YOUR_EVENT_ID"; // from Step 1
const response = await fetch(
`https://api.altsportsdata.com/api/v1/public/events/${eventId}/eventWinner`,
{
headers: { "X-API-Key": "demo-0001" },
}
);
const market = await response.json();
for (const outcome of market.data.outcomes) {
console.log(`${outcome.name}: ${outcome.odds}`);
}import requests
event_id = "YOUR_EVENT_ID" # from Step 1
response = requests.get(
f"https://api.altsportsdata.com/api/v1/public/events/{event_id}/eventWinner",
headers={"X-API-Key": "demo-0001"},
)
market = response.json()
for outcome in market["data"]["outcomes"]:
print(f"{outcome['name']}: {outcome['odds']}")What you should see
A response with structured odds data, ready for immediate use:
BKFC 62: Perry vs Alvarez
Mike Perry: -180
Hector Alvarez: +150With two API calls, you have:
- Discovered events for a specific alternative sports league
- Retrieved live market data with odds for each participant
- Received sportsbook-ready output that can feed directly into a trading UI, content page, or AI agent prompt
Where to go next
Building a sportsbook feed?
Integrate league coverage, event feeds, and settlement workflows.
Publishing content or embeds?
Power editorial products and audience experiences with real-time sports data.
Onboarding a league?
Start the data partnership and onboarding workflow for league operators.
Building with AI?
Connect ALT Sports Data to Claude, Cursor, and other MCP-compatible clients.
Prefer an SDK?
Use the TypeScript or Python SDK for typed responses and built-in auth handling.
Full API reference
Explore every endpoint -- events, odds, futures, sports, markets, and more.