Quickstart

First request in 60 seconds.

1. 01

   Create an account. Free tier, no credit card.

2. 02

   Open API Keys in your dashboard and copy your key. It looks like sk_live_… (or sk_test_… for sandbox testing).

3. 03

   Set the key in your shell, then make your first request — list every competition:

   export STATSHAWK_KEY="sk_live_YOUR_KEY_HERE"

   curlpythonnode

   curl -H "X-API-Key: $STATSHAWK_KEY" \
     https://api.statshawk.ai/v1/competitions

   Expected response (truncated):

   {
     "data": {
       "items": [
         {
           "id": "comp_2r9wq7k3",
           "slug": "nba",
           "name": "National Basketball Association",
           "sport": "Basketball",
           "kind": "DomesticClub"
         }
       ],
       "total": 12
     },
     "meta": {
       "request_id": "550e8400-e29b-41d4-a716-446655440000",
       "fetched_at": "2025-01-01T00:00:00Z",
       "cache": "HIT",
       "version": "v1"
     }
   }

→Run /v1/competitions live in the playground →›

Next steps

• Authentication — key format, live vs test, revocation
• Quotas — what counts as a unit and plan limits
• REST API reference — every endpoint, with a try-it playground