Coverage & data model

SharpRelay delivers a reviewed, independently operated REST contract around Pinnacle-sourced sports, events, prices, results, and special markets. The catalog is broad, but availability remains event- and time-specific.

Historical sport catalog

The reviewed snapshot contains: Soccer, Basketball, Tennis, Baseball, Hockey, E Sports, Football, Handball, Volleyball, Rugby Union, MMA, Rugby League, Aussie Rules, Golf, Futsal, Boxing, Badminton, Water Polo, Darts, Snooker, Cycling, Biathlon, Curling, Cricket, Bandy, Cross Country, Alpine Skiing, Athletics, Olympics, Formula 1, Ski Jumping, Table Tennis, Sumo, Chess, Beach Volleyball, Padel Tennis, Field Hockey, Entertainment, Squash, Slap Fighting, Motorsport, Lacrosse, Softball, and Crossfit.

Historical depth varies substantially by sport. The static list deliberately does not freeze sport IDs, league IDs, period definitions, or offering flags; discover those through the authenticated catalog so your integration remains correct when source metadata changes.

Market surface

Prices are decimal. Corresponding margin-removed fair prices are included when supplied. The contract also covers opening lines, closing lines, available historical movement, event results, cancellations, re-settlements, and CLV analysis.

Props, specials & outrights

The reviewed source snapshot reported specials data across ten source sport labels, including player props, team props, and game props. Coverage is contestant-based and can change independently of standard event lines. One specials-only source label was not silently merged with a standard sport; resolve the current sport and market IDs through the API catalog.

Outrights cover competition and tournament markets that are not tied to one event. Their publication and settlement timelines differ from event markets, so discover them through /v1/outrights rather than inferring them from event availability. For both event props and outrights, use the returned special_id as prop_id on /v1/props/{prop_id}/odds and retrieve one market at a time.

The v1 beta intentionally does not expose event-wide bulk prop prices or prop-specific opening, closing, results, and CLV operations.

What the contract covers

Coverage discovery workflow

1. List the current API sport catalog and retain the opaque sport_id; account for its roughly one-hour cache window.
2. Enumerate the sport's leagues and period definitions.
3. Query /v1/events by league or sport for future pre-match fixtures. Without an explicit kickoff window, ordinary discovery applies a request-current lower bound and filters again at delivery, so returned starts remain strictly future. Supplying a present or future starts_from, normally together with starts_to, narrows the future window and remains locally enforced; only a genuinely past lower bound is the explicit historical-discovery path. Exact event_id and parent_id lookups are lifecycle-specific rather than future-only.
4. Query live=1 separately for currently offered in-play events. Without an explicit starts_from, live discovery applies no minimum kickoff; add one only to narrow the candidate window. This route is not response-cached. It reads the complete bounded candidate boundary, then performs bounded per-page verification. Every returned event must have live_status=1 and an event-bound latest open line whose cutoff is still strictly future when expiry is rechecked at final validation.
5. Use returned event IDs and availability flags to request odds, opening, closing, results, and special markets.
6. For live=1, follow every X-Next-Cursor within five minutes—even after an empty page—until the header is absent. If X-Result-Truncated: true remains without a next cursor, narrow the sport, league, or kickoff window. For pre-game incremental discovery, use a moving since value; the implicit future boundary still applies unless you explicitly choose a kickoff window.

Price-side semantics

Availability and completeness

Fields are optional or nullable because availability varies by sport, event, market, and lifecycle state. Unknown source fields are removed. A successful empty array means no matching rows are currently available; a CLV 404 means no suitable event or closing line could be matched and is not a zero-value analysis.

Event odds default to the greatest positive line_id snapshot for each event and period, retaining every primary and alternate market row present at that snapshot and excluding older off-board line IDs. Prop odds default to one greatest-line_id row per special_id + contestant_line_id; handicap is a value on the winning row, not a separate latest identity. Set full_history=1 to request available matching history. Event odds additionally accept a moving since cursor for incremental history; use it by itself or with full_history=1, because since=...&full_history=0 is rejected. Inspect X-Result-Truncated and never assume a historical response is complete. Opening and closing routes return the first or latest available line, respectively, only where those snapshots exist. Closing rows and results can be corrected or re-settled, so refresh them whenever revisions matter.