You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
docs(reference): correct auth labels for /sports, /leagues, /markets, /sportsbooks, /teams
These five endpoints are wrapped in authMiddleware on the server (verified:
all return 401 without an API key) but every public-facing surface said
otherwise:
- 5 MDX files (sports, leagues, markets, sportsbooks, teams) claimed
"public endpoint, no authentication required" and showed unauthenticated
curl/JS/Python examples
- public/openapi.json declared `security: [{}, {ApiKeyHeader: []}]` for
each (the empty {} marks auth as optional) and listed no 401 response
Updated the MDX callouts to "Requires an API key. Available on all tiers
(Free included)." and added the X-API-Key header to every example. In the
spec, replaced the security blocks with the global standard set
(ApiKeyHeader / BearerAuth / ApiKeyQuery) and added the Unauthorized 401
response.
/health and /deeplink/{id} remain genuinely public and were left untouched.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Copy file name to clipboardExpand all lines: content/en/api-reference/leagues.mdx
+10-8Lines changed: 10 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -13,7 +13,7 @@ GET /api/v1/leagues
13
13
```
14
14
15
15
<Callouttype="info">
16
-
This is a **public endpoint** -- no authentication required. Unauthenticated requests are rate-limited to 10 requests/minute. Authenticated requests receive your tier's full rate limit.
16
+
Requires an API key. Available on all tiers (Free included). Unauthenticated requests return `401`.
17
17
</Callout>
18
18
19
19
## Query Parameters
@@ -27,18 +27,20 @@ This is a **public endpoint** -- no authentication required. Unauthenticated req
27
27
<Tabsitems={['cURL', 'JavaScript', 'Python']}>
28
28
<Tabs.Tab>
29
29
```bash
30
-
# List all leagues (no auth required)
31
-
curl -X GET "https://api.sharpapi.io/api/v1/leagues"
30
+
# List all leagues
31
+
curl -X GET "https://api.sharpapi.io/api/v1/leagues" \
32
+
-H "X-API-Key: YOUR_API_KEY"
32
33
33
34
# Filter by sport
34
-
curl -X GET "https://api.sharpapi.io/api/v1/leagues?sport=basketball"
35
+
curl -X GET "https://api.sharpapi.io/api/v1/leagues?sport=basketball" \
36
+
-H "X-API-Key: YOUR_API_KEY"
35
37
```
36
38
</Tabs.Tab>
37
39
<Tabs.Tab>
38
40
```javascript
39
-
// No API key required for public reference endpoints
Copy file name to clipboardExpand all lines: content/en/api-reference/markets.mdx
+13-6Lines changed: 13 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -13,7 +13,7 @@ GET /api/v1/markets
13
13
```
14
14
15
15
<Callouttype="info">
16
-
This is a **public endpoint** -- no authentication required. Unauthenticated requests are rate-limited to 10 requests/minute. Authenticated requests receive your tier's full rate limit.
16
+
Requires an API key. Available on all tiers (Free included). Unauthenticated requests return `401`.
17
17
</Callout>
18
18
19
19
## Query Parameters
@@ -27,16 +27,20 @@ This is a **public endpoint** -- no authentication required. Unauthenticated req
27
27
<Tabsitems={['cURL', 'JavaScript', 'Python']}>
28
28
<Tabs.Tab>
29
29
```bash
30
-
# List all markets (no auth required)
31
-
curl -X GET "https://api.sharpapi.io/api/v1/markets"
30
+
# List all markets
31
+
curl -X GET "https://api.sharpapi.io/api/v1/markets" \
32
+
-H "X-API-Key: YOUR_API_KEY"
32
33
33
34
# Filter by sport
34
-
curl -X GET "https://api.sharpapi.io/api/v1/markets?sport=basketball"
35
+
curl -X GET "https://api.sharpapi.io/api/v1/markets?sport=basketball" \
Copy file name to clipboardExpand all lines: content/en/api-reference/sports.mdx
+8-9Lines changed: 8 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -15,7 +15,7 @@ GET /api/v1/sports
15
15
```
16
16
17
17
<Callouttype="info">
18
-
These are **public endpoints** -- no authentication required. Unauthenticated requests are rate-limited to 10 requests/minute. Authenticated requests receive your tier's full rate limit.
18
+
Requires an API key. Available on all tiers (Free included). Unauthenticated requests return `401`.
19
19
</Callout>
20
20
21
21
## List All Sports
@@ -25,18 +25,15 @@ These are **public endpoints** -- no authentication required. Unauthenticated re
25
25
<Tabsitems={['cURL', 'JavaScript', 'Python']}>
26
26
<Tabs.Tab>
27
27
```bash
28
-
# No API key required
29
-
curl -X GET "https://api.sharpapi.io/api/v1/sports"
30
-
31
-
# With API key for higher rate limits
32
28
curl -X GET "https://api.sharpapi.io/api/v1/sports" \
33
29
-H "X-API-Key: YOUR_API_KEY"
34
30
```
35
31
</Tabs.Tab>
36
32
<Tabs.Tab>
37
33
```javascript
38
-
// No API key required for public reference endpoints
Copy file name to clipboardExpand all lines: content/en/api-reference/sportsbooks.mdx
+8-7Lines changed: 8 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -15,7 +15,7 @@ GET /api/v1/sportsbooks
15
15
```
16
16
17
17
<Callouttype="info">
18
-
These are **public endpoints** -- no authentication required. Unauthenticated requests are rate-limited to 10 requests/minute. Authenticated requests receive your tier's full rate limit.
18
+
Requires an API key. Available on all tiers (Free included). Unauthenticated requests return `401`.
19
19
</Callout>
20
20
21
21
## List All Sportsbooks
@@ -25,17 +25,15 @@ These are **public endpoints** -- no authentication required. Unauthenticated re
25
25
<Tabsitems={['cURL', 'JavaScript', 'Python']}>
26
26
<Tabs.Tab>
27
27
```bash
28
-
# No API key required
29
-
curl -X GET "https://api.sharpapi.io/api/v1/sportsbooks"
30
-
31
-
# With API key for higher rate limits
32
28
curl -X GET "https://api.sharpapi.io/api/v1/sportsbooks" \
0 commit comments