Skip to content

docs: TeamRef logo/city/mascot/conference/division (Phase 2c)#215

Draft
Mlaz-code wants to merge 2 commits into
mainfrom
docs/team-metadata-phase-2c
Draft

docs: TeamRef logo/city/mascot/conference/division (Phase 2c)#215
Mlaz-code wants to merge 2 commits into
mainfrom
docs/team-metadata-phase-2c

Conversation

@Mlaz-code
Copy link
Copy Markdown
Collaborator

Phase 2c docs. Stacks on PR #214 (Phase 1g). Documents the 5 new optional team metadata fields across odds, ev, arbitrage, middles, teams reference, and entity-reference-ids concept page.

  • next build clean
  • tsc --noEmit clean

🤖 Generated with Claude Code

@vercel
Copy link
Copy Markdown

vercel Bot commented May 7, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs.sharpapi.io Ready Ready Preview, Comment May 7, 2026 2:00pm

Request Review

Mlaz-code and others added 2 commits May 12, 2026 21:17
Document the new optional `numerical_id` field on each reference endpoint
(/sports, /leagues, /sportsbooks, /markets, /teams) plus the nested
`home`, `away`, `sport_ref`, `league_ref`, `market_ref`, `sportsbook_ref`
blocks emitted on every odds row and EV / arbitrage / middles opportunity
leg. Adds /teams `abbreviation` field. New concept page
`entity-reference-ids.mdx` covers the dense-from-1 / frozen / never-reused
contract and migration guidance.

Additive only — every flat string field remains in every response.

Companion to api-adapters#489 (atlas backfill + Python adapter wire format)
and sharp-api-go#345 (Go decode + reference endpoint surface). Both ship
under the OpticOdds-parity Phase 1 work.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Companion to:
- api-adapters PR #489 (refreshed) - Phase 1 atlas backfill
- sharp-api-go PR #345 - Go decode + reference endpoints
- sharp-api-go feat/team-metadata-phase-2c - extend TeamRef
- sharpapi-python feat/team-metadata-phase-2c - pydantic types
- sharpapi-ts feat/team-metadata-phase-2c - TypeScript types

Documents the 5 new optional fields on the nested team object: logo, city,
mascot, conference, division. All backfilled from OpticOdds via
api-adapters PR #499. Coverage ~93% of teams; individual-sport competitors
(tennis players, MMA fighters, golfers) remain unset by design.

Files updated:
- content/en/concepts/entity-reference-ids.mdx — TeamRef section + new
  per-field reference table
- content/en/api-reference/odds.mdx — schema row + JSON sample
- content/en/api-reference/opportunities-ev.mdx — schema row
- content/en/api-reference/opportunities-arbitrage.mdx — schema row + JSON sample
- content/en/api-reference/opportunities-middles.mdx — schema row + JSON sample
- content/en/api-reference/teams.mdx — full schema table + 2 JSON samples + concept section

next build clean. tsc --noEmit clean. New (May 2026) markers added
consistently for visual diff with existing fields.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@Mlaz-code Mlaz-code force-pushed the docs/team-metadata-phase-2c branch from 9e02b66 to 42f275c Compare May 13, 2026 01:17
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant