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": [
    { "league": "mlb", "sport": "baseball", "name": "MLB" },
    { "league": "nba", "sport": "basketball", "name": "NBA" }
  ]
}

Read some live data

Now fetch games for a league. Per-league data reads are billed against your monthly quota:

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

Most list endpoints accept filters like date, status, and team. 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();
console.log(data);

import requests

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

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

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