v25

OpenAPI 3.1.0raw.githubusercontent.com2026-08-015486519.4 KB
Pick of the Day

Get today's Pick of the Day

One sourced sharp-money call a day (Pro-tier). Returns the published pick for the CURRENT product day: the backed side, the pre-game odds and $100 return, the proven smart-money holders on that side, the grade, and a required truthful thesis. With proven holder backing the thesis uses the sharp-money grammar; without it the required string names the Pick of the Day without fabricating proof. The price is snapshotted before kickoff so it does not drift. It never serves a prior day's finished pick as today's, so an automated consumer never acts on a stale, already-settled game (a prior pick stays available through the archive endpoint). When no pick is published for the current product day it returns 404 with error.code="not_found" and error.reason="pick_not_released" -- branch on the reason, because error.code is a frozen contract and stays "not_found". That 404 is a schedule, not an outage: each selected pick normally releases one hour before its provider kickoff, within the 11:00-23:00 UTC operating window; a skipped day has no release. DO NOT POLL. error.retry_at (RFC3339, always in the future) and Retry-After give the recommended next attempt: the automatic release boundary before a selected pick; normally the persisted next automatic selector attempt (~15m) while no candidate exists; or a ~60s degradation when that schedule is absent, due, or a pick is overdue. Every value is advisory under supported operator actions: manual publication, release-time override, or admin generation can make a pick available first. Schedule one request rather than sleeping a worker thread.

get/api/v1/pick-of-the-day

Headers

If-None-Matchstring

Conditional GET validator from a previous ETag. Matching values return 304 Not Modified with an empty body.

Response

Today's Pick of the Day

object'pick_of_the_day' required