Quickstart

This guide walks you from zero to a live response. You’ll need a workspace API token — get one from your dashboard at sportquanta.com.

Get your API token

API tokens are issued per workspace. Keep your token secret — it carries your organization’s quota and is sent on every request. Treat it like a password and never embed it in client-side code.

Make your first request

Every request goes to https://api.sportquanta.com and carries your token in the Authorization header. Start with a free catalog endpoint — it doesn’t consume quota:

curl https://api.sportquanta.com/v1/leagues \
  -H "Authorization: Bearer YOUR_API_TOKEN"

You’ll get back the standard success envelope:

{
  "data": [
    { "id": "mlb", "sport": "baseball", "display_name": "Major League Baseball", "region": "USA" },
    { "id": "nba", "sport": "basketball", "display_name": "National Basketball Association", "region": "USA" }
  ]
}

Read some live data

Now fetch games for a league. Per-league data reads are billed against your monthly quota and require a paid plan — without one this returns 403 feature_not_in_plan. See Rate Limits & Quota for what each plan covers:

curl "https://api.sportquanta.com/v1/mlb/games?date=2026-06-29" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Schedule rows are in data.items, with an optional data.next_cursor. Use returned canonical IDs for follow-up game, lineup, odds, and player reads. Schedule endpoints accept filters like date, status, and team_id. See Pagination & Filtering for the shared query conventions.

Explore in the playground

Open the API Reference, paste your token into the playground, and call any endpoint directly from the docs.

Language examples

curl "https://api.sportquanta.com/v1/mlb/games?date=2026-06-29" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

const res = await fetch("https://api.sportquanta.com/v1/mlb/games?date=2026-06-29", {
  headers: { Authorization: "Bearer YOUR_API_TOKEN" },
});
const { data } = await res.json();
if (!res.ok) throw new Error(`Request failed: ${res.status}`);
console.log(data.items);

import requests

res = requests.get(
    "https://api.sportquanta.com/v1/mlb/games",
    params={"date": "2026-06-29"},
    headers={"Authorization": "Bearer YOUR_API_TOKEN"},
)
res.raise_for_status()
print(res.json()["data"]["items"])

req, _ := http.NewRequest("GET",
    "https://api.sportquanta.com/v1/mlb/games?date=2026-06-29", nil)
req.Header.Set("Authorization", "Bearer YOUR_API_TOKEN")
resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))

Next steps

Authentication

Tokens, scopes, and the auth header in detail.

Responses & Errors

The success/error envelope and status codes.

Rate Limits & Quota

What’s billed, what’s free, and how throttling works.

Data Domains

Map a product feature to the endpoints that serve it.

Get Started

Core Concepts

Data & Integration

Agents

Language examples

Next steps

Authentication

Responses & Errors

Rate Limits & Quota

Data Domains

​Language examples

​Next steps

Authentication

Responses & Errors

Rate Limits & Quota

Data Domains

Language examples

Next steps