CLV

Closing line value (CLV) and expected win for a single bet

Given a bet description (no event_id needed), finds the matching Pinnacle event via fuzzy name + time matching, then returns Pinnacle closing odds, true (de-vigged) closing odds, expected win and CLV.

Line convention: pass the line from your bet's perspective.

  • "Lakers -3.5" → line=-3.5 selection=home
  • "Celtics +3.5" (away getting points) → line=3.5 selection=away
  • "Over 220.5" → line=220.5 selection=over

Formulas:

  • clv = bet_price / true_closing_odds - 1
  • expected_win = bet_stake * clv

Event matching: Returns 404 if no candidate is found.

get/api/clv

Request

  • Base URL: https://api.bettingiscool.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.bettingiscool.com/api/clv
  • Auth: API key in header X-API-Key

Query parameters

startsstring required

Bet event start time. ISO format YYYY-MM-DD or YYYY-MM-DD HH:MM:SS. Matched within ±24h.

sport_idinteger required

Pinnacle sport ID. Call /api/sports to list.

runner_homestring required

Home team/runner name as your records have it. Fuzzy matched against fixtures.

runner_awaystring required

Away team/runner name as your records have it. Fuzzy matched against fixtures.

market'moneyline' | 'spread' | 'totals' | 'home_totals' | 'away_totals' required

Market type.

periodinteger required

0 = full match/game, 1 = 1st half/period/set, 2 = 2nd, ... Call /api/periods for sport-specific definitions.

selection'home' | 'draw' | 'away' | 'over' | 'under' required

Side bet on. moneyline → home/draw/away. spread → home/away. totals/home_totals/away_totals → over/under.

bet_stakenumber required

Stake amount (any currency — output expected_win is in the same units).

bet_pricenumber required

Decimal odds you got at your book.

linenumber nullable

Line value. Required for spread/totals/home_totals/away_totals. Omit for moneyline. Pass from your bet's perspective.

Response

Successful Response

unknown required

Changes

No recorded changes to this operation across all 1 revision of this API.