Getting started
Integrate Grid Ledger
Connect your backend to the Grid Ledger esports data API. Keys and env vars live on the server only.
1. Create an API key
- Sign in to the dashboard.
- Open API Keys and create a key.
- Copy the full
sk_live_…value once (it is not shown again).
| Plan | Keys | Daily requests |
|---|---|---|
| Free | Up to 5 | 100 / day |
| Paid | Unlimited | 1,000 / day |
2. Configure your app
Set these on your server (e.g. .env or Railway). Do not use NEXT_PUBLIC_.
GRID_LEDGER_API_URL="https://gridledger.pro/v1" GRID_LEDGER_API_KEY="sk_live_YOUR_KEY"
3. Call the API
Send the key as a Bearer token on every request:
curl -sS \ -H "Authorization: Bearer $GRID_LEDGER_API_KEY" \ "$GRID_LEDGER_API_URL/fixtures?game=cs2&limit=5"
Success returns { "data": [ … ] }. Invalid key → 401. Over quota → 429.
4. Endpoints by use case
| Need | Call |
|---|---|
| Match / team / player lookup | GET /search, /teams, /players |
| Upcoming / live matches | GET /fixtures?game=cs2|lol|valorant |
| Finished matches | GET /results |
| Single match (maps, box scores) | GET /matches/:id |
| Filtered match list | GET /matches |
| Leagues / tournaments | GET /leagues, /tournaments |
Full list: API reference. Auth details: Authentication. Quotas: Rate limits.