Data Source Rule
Public LineAlgo pages read stored API Warehouse data only. The browser does not call paid provider APIs directly.
- Opening lines, closing lines, line movement rows, proof rows, W/L records, scores, and sportsbook coverage must come from Warehouse-backed storage or static Warehouse shards.
- If Warehouse rows are missing or stale, THE SYSTEM must warn the user instead of pretending the board is complete.
- Fallback rows can be displayed for investigation, but they must not be silently promoted into trusted proof.
Open / Close Anchors
| Label | Meaning | Trusted? |
|---|---|---|
| PROVIDER_OFFICIAL_OPEN | Provider payload explicitly identifies this as the official opening line. | Yes |
| PROVIDER_OFFICIAL_CLOSE | Provider payload explicitly identifies this as the official closing line. | Yes |
| OA_OPENING_LINE | Earliest valid saved pregame Odds API snapshot for the exact game, sportsbook, market, and side scope. | Yes, Warehouse-derived |
| OA_CLOSING_LINE | Latest valid saved pregame Odds API snapshot at or before game start for the exact scope. | Yes, Warehouse-derived |
| FIRST_CAPTURE_UNVERIFIED | The first row LineAlgo captured, but not enough history exists to call it a true open. | No |
| LATEST_CAPTURE_UNVERIFIED | The latest row LineAlgo captured, but not enough anchor evidence exists to call it a true close. | No |
Important: row roles such as OPENING_LINE and CLOSING_LINE are display roles. Proof quality comes from the anchor status above.
Pattern Families
ForwardStarts at a trusted open anchor and reads later pregame rows.
ReverseStarts at a trusted close anchor and reads prior pregame rows.
ProviderProvider official anchor, only when metadata proves it.
OAOdds API-derived Warehouse anchor from saved snapshots.
DiagnosticInvestigation only. Not trusted final proof.
| Selector | What it means | Use |
|---|---|---|
| Trusted Forward + Reverse | Loads trusted forward and trusted reverse rows together. | Default view. |
| Provider Open -> OK | Provider official open to later normal pregame rows. | Highest confidence forward family when provider open exists. |
| Provider Open -> Provider Close | Provider official open to provider official close. | Highest confidence open-to-close proof. |
| Provider Open -> OA Close | Provider official open to Warehouse-derived close. | Trusted mixed-anchor proof. |
| OA Open -> OK | Warehouse-derived open to later normal pregame rows. | Main Odds API Warehouse forward family. |
| OA Open -> OA Close | Warehouse-derived open to Warehouse-derived close. | Main Warehouse open-to-close family. |
| Provider Close -> Prior OK | Provider official close back to earlier pregame rows. | Reverse mode from official close. |
| OA Close -> Prior OK | Warehouse-derived close back to earlier pregame rows. | Main Warehouse reverse family. |
| Diagnostic Open -> Latest Capture | Trusted open to latest capture when no trusted close exists. | Investigation only. |
Forward and reverse proof keys, SIZ values, W/L counts, and proof logs must never be mixed. In-game rows are separate and do not affect pregame proof.
W/L Proof
Every W/L chip is a historical pattern match. It is not a prediction pulled from thin air.
- Past Record mode uses only games before the selected target date.
- Post Record mode uses games after the selected target date.
- Each W/L chip must remain clickable to real past game-log proof rows.
- Rows outside the selected pattern family should show unavailable family state, not fake 0-0 proof.
- Unverified first/latest captures cannot silently create proof keys.
Value Math
Value is calculated as if each historical example was a $100-style play using the row price.
- For American favorites, LineAlgo risks the favorite price to win $100.
- For American dogs, LineAlgo risks $100 to win the plus-money payout.
- For normal spreads and totals where no specific price is available, LineAlgo uses -110 default vig.
- Moneyline value uses the actual side price when available.
Example: if a -200 favorite record is 2-1, the two wins make +$200, the one loss costs -$200, and the value is $0.
Best Logic
THE SYSTEM shows best records above the columns and top sliders above the board. The goal is to surface both strongest record quality and strongest value.
- Best record favors the largest win/loss gap.
- If records have the same gap, the side with more sportsbook occurrences can rank higher than a one-off record.
- If tied records exist, both should be shown.
- Best value ranks by dollar value, but top records must still remain visible in the Top Records slider.
- Per-column summaries use the same logic as their own W/L column, not a separate overall board shortcut.
| Surface | What it shows |
|---|---|
| Top Records | Highest ranked W/L records of the selected game board, with tied records and occurrence counts. |
| Top Value | Highest dollar value records using $100-style value math. |
| Top Sportsbooks | Best records grouped by sportsbook priority and proof yield. |
| Column headers | Best record and best value for that exact column, such as VIS W/L # or HOM W/L %. |
Sportsbook Priority
Sportsbooks are sorted by LineAlgo Priority, not alphabetically, when ALL SPORTSBOOKS is selected.
- This is not an official global sportsbook ranking.
- The first pass prioritizes market makers, exchanges, sharp offshore or low-vig books, high-liquidity global books, major regulated US books, and then regional/lower-priority books.
- Admin visibility controls can hide books from the UI without deleting Warehouse data.
- The future upgrade is a Warehouse-derived lead-lag and CLV score for each sportsbook.
Warnings And Status
| Message | Meaning |
|---|---|
| Historical coverage incomplete | Warehouse line history is missing or fallback rows are being used. Treat board coverage as incomplete. |
| Live feed stale | No fresh Warehouse line rows were seen for the board scope in over one hour. |
| No family | The selected pattern family does not apply to that row. It should not be counted as fake proof. |
| Critical | Audit flag requiring review, usually because anchor/proof metadata is incomplete or contradictory. |
| Loading W/L | The browser is fetching proof for a chip. Completed historical W/L cells should settle into a record or an unavailable-state label. |