SK Web API Reference

Overview

The SK Web API provides comprehensive access to sports data, analytics, picks, user management, and more. All endpoints support both /api/v1/... and /v1/... path prefixes.

API Categories

Category	Description	Endpoints
Sports & Leagues	Core sports hierarchy data	4
Teams & Players	Team and player information	12
Games & Matches	Game schedules, scores, stats	11
Picks & Analytics	Value picks, predictions, trends	18
Systems & Leaderboards	Betting systems, strategies	14
User Management	Authentication, settings, subscriptions	25+
Contests	Fantasy contests, leagues	13
MCP Memory	Memory store operations	10+
CMS & Widgets	Pages, files, sitemaps, widgets	15
Videos	Video content & streaming	7
Vendors	Data providers & vendor management	14
Payments	Subscriptions & billing	11
Health & Monitoring	Health checks, filters	6

Base URL

Production: https://api.yoursite.com
Development: https://localhost:44360

Authentication

API Key Authentication

For public data access, use an API key in one of these headers:

X-API-Key: your-api-key
Authorization: ApiKey your-api-key

JWT Authentication

For user-specific endpoints, include a Bearer token:

Authorization: Bearer <jwt-token>

Authentication Levels

Level	Description	Example Endpoints
Public	No auth required	`/v1/sports`, `/v1/leagues`, `/v1/games`
API Key	Valid API key required	`/v1/memory/write`, `/v1/memory/banks`
User Auth	JWT token required	`/v1/users/settings`, `/v1/users/subscriptions`
Admin	Admin role required	`/v1/admin/users`

Common Response Objects

Sport

{
  "id": 1,
  "name": "Football",
  "code": "NFL",
  "imageUrl": "https://..."
}

League

{
  "id": 1,
  "name": "National Football League",
  "code": "NFL",
  "sportId": 1,
  "sportCode": "FOOTBALL",
  "logoUrl": "https://...",
  "countryFlagUrl": "https://..."
}

Team

{
  "id": 123,
  "name": "Dallas Cowboys",
  "code": "DAL",
  "colorHex": "#003594",
  "city": "Dallas",
  "logoUrl": "https://...",
  "sportId": 1,
  "leagueId": 1
}

Party (Team in Match Context)

{
  "id": 123,
  "name": "Cowboys",
  "code": "DAL",
  "colorHex": "#003594",
  "score": 28,
  "side": "home",
  "winner": true,
  "logoUrl": "https://...",
  "rank": "3",
  "record": "8-3",
  "winProbability": 0.65
}

Match

{
  "id": 12345,
  "time": "4:25 PM ET",
  "timeRaw": "2025-11-29T21:25:00Z",
  "matchStatus": { "code": "FINAL", "display": "Final" },
  "final": true,
  "live": false,
  "party1": { ... },
  "party2": { ... },
  "televisionChannels": "FOX, NFL Network",
  "location": "AT&T Stadium"
}

Common Query Parameters (AppFilter)

Parameter	Type	Description	Example
`DateEst`	string	Date in EST timezone	`2025-11-29`
`Date`	DateTime	Specific date filter	`2025-11-29`
`StartDate`	DateTime	Start of date range	`2025-11-01`
`EndDate`	DateTime	End of date range	`2025-11-30`
`LeagueId`	long[]	Filter by league IDs	`1,2,3`
`SportId`	long[]	Filter by sport IDs	`1`
`TeamId`	long[]	Filter by team IDs	`123,456`
`MatchIds`	long[]	Filter by match IDs	`12345,67890`
`Limit`	int	Max results (default: 100)	`50`
`Live`	bool	Only live games	`true`
`Sort`	string	Sort order	`date:desc`

Error Responses

Standard Error Format

{
  "error": "error_code",
  "message": "Human readable error message"
}

Common Error Codes

Code	HTTP Status	Description
`unauthorized`	401	Missing or invalid authentication
`forbidden`	403	Insufficient permissions
`not_found`	404	Resource not found
`invalid_request`	400	Malformed request
`rate_limited`	429	Too many requests
`server_error`	500	Internal server error

Rate Limiting

Standard: 100 requests/minute
Premium: 1000 requests/minute
Headers returned:
- X-RateLimit-Limit: Max requests per window
- X-RateLimit-Remaining: Remaining requests
- X-RateLimit-Reset: Unix timestamp when limit resets

Versioning

The API uses URL versioning. Current stable version is v1.

/v1/games
/v2/games (enhanced with value grades)

Quick Start Examples

Get Today's NFL Games

curl -X GET "https://api.yoursite.com/v1/matches?LeagueId=1&DateEst=2025-11-29"

Get Live Games

curl -X GET "https://api.yoursite.com/v2/games?Live=true"

Authenticate User

curl -X POST "https://api.yoursite.com/v1/users/authenticate" \
  -H "Content-Type: application/json" \
  -d '{"username": "user@example.com", "password": "yourpassword"}'

Search Memory (MCP)

curl -X POST "https://api.yoursite.com/v1/memory/search" \
  -H "X-API-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"query": "NFL betting trends", "topK": 5}'

SDK Support

JavaScript/TypeScript: npm package available
C#/.NET: NuGet package available
Python: pip package available

Changelog

See CHANGELOG.md for version history and breaking changes.