For tools, embeds, and journalism

API

A read-only, CORS-friendly public API over Diamondwire's canonical data. Free; rate-limited per IP. Send a Bearer key for a higher limit.

Endpoints

GET/api/public/v1/rankings
Current RPI snapshot. One row per team with rank, RPI, WP1/2/3, SOS rank.
```
curl https://diamondwire.com/api/public/v1/rankings
```
GET/api/public/v1/teams/{team_id}
Team detail: rank, RPI components, record splits, quality wins, bad losses, auto-bid prob.
```
curl https://diamondwire.com/api/public/v1/teams/Vanderbilt
```
GET/api/public/v1/teams/{team_id}/schedule
Played + upcoming games for one team, chronological. Includes opponent ranks.
```
curl https://diamondwire.com/api/public/v1/teams/Vanderbilt/schedule
```
GET/api/public/v1/field
Projected 64-team NCAA tournament field with national seeds, bid type, first-four-out, and any bid stealers.
```
curl https://diamondwire.com/api/public/v1/field
```
GET/api/public/v1/games/{game_slug}
Single game detail. Slug shape: YYYY-MM-DD-AwayId-vs-HomeId (same as /game URLs).
```
curl https://diamondwire.com/api/public/v1/games/2026-05-24-Arkansas-vs-Georgia
```
GET/api/public/v1/games/{game_slug}/plays
Full play log for one game with win-probability and leverage. Empty until play-by-play ingestion populates it.
```
curl https://diamondwire.com/api/public/v1/games/2026-05-24-Arkansas-vs-Georgia/plays
```
GET/api/public/v1/standings
Conference standings grouped by league, with conference record + RPI rank per team.
```
curl https://diamondwire.com/api/public/v1/standings
```
GET/api/public/v1/sos
Strength-of-schedule per team with opponent rank-bucket distribution (top-25, 26-75, 76-150, 151-225, 226+).
```
curl https://diamondwire.com/api/public/v1/sos
```
GET/api/public/v1/leaders?category=avg&limit=25
National leaderboards. Categories: avg, obp, slg, hr, rbi, sb, era, k_per_9, whip, wins, saves. Empty until the player layer ingests.
```
curl 'https://diamondwire.com/api/public/v1/leaders?category=era&limit=10'
```

Rate limits

Unkeyed (IP): 10 / min
Keyed (Bearer): 60 / min

Every response carries X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset. When the limit is exceeded the server returns 429. Send an API key as Authorization: Bearer dw_yourkey or ?api_key=dw_yourkey for the higher tier.

Versioning

Endpoints are versioned in the path (/api/public/v1/...). Breaking changes ship under a new version; v1 stays stable until a v2 is published. Add-only changes (new fields on responses) happen in place. The changelog lists every breaking change.

Attribution

Free use, including commercial. Please include a visible link back to diamondwire.comon pages that surface our numbers — it's how we close the trust loop and how we hear from readers who spot anomalies.