Guides

Code examples

Copy-paste starters. Replace the base URL or key as needed.

cURL

curl -sS \
  -H "Authorization: Bearer $GRID_LEDGER_API_KEY" \
  "https://gridledger.pro/v1/fixtures?game=lol&limit=10"

JavaScript / TypeScript

const res = await fetch('https://gridledger.pro/v1/matches?game=cs2&status=finished&limit=5', {
  headers: { Authorization: `Bearer ${process.env.GRID_LEDGER_API_KEY}` },
});
if (!res.ok) throw new Error(await res.text());
const { data } = await res.json();
for (const m of data) {
  console.log(m.team1.name, m.scoreTeam1, m.scoreTeam2, m.team2.name);
}

Python

import os, requests

API = "https://gridledger.pro/v1"
headers = {"Authorization": f"Bearer {os.environ['GRID_LEDGER_API_KEY']}"}

matches = requests.get(f"{API}/results", params={"game": "cs2", "limit": 10}, headers=headers)
matches.raise_for_status()
for m in matches.json()["data"]:
    print(m["team1"]["name"], m.get("scoreTeam1"), m.get("scoreTeam2"), m["team2"]["name"])

Next.js route handler

// app/api/fixtures/route.ts
export async function GET() {
  const response = await fetch(
    'https://gridledger.pro/v1/fixtures?game=cs2',
    { headers: { Authorization: `Bearer ${process.env.GRID_LEDGER_API_KEY!}` }, next: { revalidate: 60 } },
  );
  return Response.json(await response.json());
}

More detail: Authentication · API reference