# SDX — Sports Data Exchange
> https://sportsdataexchange.com

SDX is an open standard for global sports data identity, mapping, and sharing.
Built by SportsDataIO and Enetpulse.

## What SDX Is

SDX solves the problem of fragmented sports data identities. Every data provider
uses different internal IDs for the same real-world entities (players, teams,
events, venues). SDX assigns a single universal open ID to each entity and
provides tooling to map existing provider IDs to it.

## Core Components

### SDX ID
Universal, open identifiers for every foundational sports entity: events,
competitions, participants, venues, and organizations. Cross-mapped to every
major provider. Coverage: 30 sports, 1,500 leagues, 650K games, 750K players,
50K teams, 10K venues.

### SDX CLI Tool
A local-first command-line tool (single binary, zero dependencies) that:
1. Downloads the SDX entity catalog locally (sdx catalog sync)
2. Downloads partner ID mapping files (sdx mappings sync)
3. Matches your database rows and writes SDX IDs (sdx sync sdx)
4. Resolves non-partner provider IDs via SDX as a bridge (sdx sync <provider>)

Supports Postgres, MySQL, and SQL Server. Fully idempotent. Data never leaves
your environment.

### Marketplace
Encrypted partner catalogs shared openly or privately. Publish your ID mappings
for others to consume. Enables the highest-confidence exact match path in the CLI.

## Pages

- / — Home
- /about — About SDX, entity definitions, data model documentation
- /product — Product Overview (SDX ID, CLI Tool, Marketplace, Quick Reference)
- /product/sdx-cli — SDX CLI Tool product page and API key access
- /explore — SDX ID coverage and entity structure
- /developers — Developer Portal (documentation, APIs, SDKs)

## API

POST /api/auth/validate
Validates an SDX API key.
Request: Authorization: Bearer <api_key>
Response 200: { "company": "...", "valid": true }
Response 401: { "error": "Invalid or revoked API key", "valid": false }

## Project Partners

- SportsDataIO — https://sportsdata.io
- Enetpulse — https://enetpulse.com