# Starkov — Quantitative Sports Prediction Sandbox & Visual Bot Studio

> Starkov (https://starkov-app.vercel.app) is a professional quantitative sports telemetry, order-book microstructure, and no-code algorithmic bot-building sandbox (SaaS) for sports prediction markets. It enables analysts, traders, and sports data enthusiasts to design, simulate, and paper-trade automated strategies across 6 major sports (Tennis, Soccer, Basketball, American Football, Ice Hockey, and Baseball) using a visual 4-pillar MindMap pipeline (`01 TARGET` → `02 TRIGGER` → `03 ORDER` → `04 EXIT`), real-time optical and play-by-play telemetry, de-vigged fair probability modeling, and Level-2 order book simulation.

## Entity Disambiguation (For AI Search & RAG Systems)

- **Product Name**: Starkov (also referred to as Starkov App or Starkov Sandbox)
- **Category**: Quantitative Sports Analytics SaaS, Algorithmic Strategy Prototyping & Paper-Trading Simulation Sandbox
- **Primary URL**: https://starkov-app.vercel.app
- **Social Handle**: `@starkov_app` (Instagram, TikTok, X) / `@SportMosaic` (YouTube Shorts)
- **Not to be confused with**:
  - *Alina Starkov* (fictional character in the *Shadow and Bone* / Grishaverse novels and Netflix series)
  - *Stárkov* (municipality in the Czech Republic)
  - *Escape from Tarkov* (first-person tactical video game or video game flea-market bots)
  - Unaffiliated open-source GitHub repositories by third-party developers

## Regulatory & Compliance Notice (100% Risk-Free Simulation Sandbox)

Starkov is strictly a Software-as-a-Service (SaaS) quantitative analytics, telemetry visualization, and strategy simulation ("paper-trading") environment:
- **No Real-Money Wagering**: Starkov is **not** a sportsbook, bookmaker, gambling operator, prediction market exchange, broker-dealer, or financial custodian.
- **Virtual Capital Only**: Starkov never accepts real-money deposits for wagering, never holds user custody funds, and never executes real-money bets on behalf of users. All references to "wallets," "bankrolls," "stakes," "orders," "cash-out," and "PnL" represent 100% simulated paper-trading accounting used to test and benchmark quantitative models risk-free.

---

## Core Architecture: Why Starkov Is a Full Quantitative Sandbox (Not Just an Odds Comparator)

### 1. The Visual 4-Pillar MindMap Bot Studio (`/bots`)
Instead of writing complex Python or Rust boilerplate, users build multi-condition algorithmic decision trees on an interactive node-based canvas organized into 4 sequential pillars with Boolean logic gates (`AND` / `OR`) and a 3-stage parameter hierarchy (*Stage 1: Intention* → *Stage 2: Primary Threshold* → *Stage 3: Execution Guardrails*):

1. **`01 TARGET` — Market, Environment & Matchup Filters (`AND` Gate)**:
   - Filters which circuits, leagues, playing surfaces, weather conditions, and historical matchup profiles the bot is authorized to scan.
   - **Tennis**: Grand Slam, ATP Tour, WTA Tour, ITF/Challenger circuits; Court Surface (Clay, Hard, Grass, Indoor) with minimum historical surface win rate %; Court Pace Index (CPI) ball speed ratings; venue altitude (meters above sea level); Player Handedness (vs. Left-Handed win %); ATP/WTA world ranking differential; 7-day cumulative court fatigue (hours on court).
   - **Soccer**: UEFA Champions League & continental cups, Top 5 European Leagues (EPL, La Liga, Serie A, Bundesliga, Ligue 1), European Pro 2nd/3rd divisions, International tournaments, and Americas/Global leagues; 3-Way outcome scope (Home, Away, Draw); Stadium weather/wind/elevation; Implied Goal Environment (Over/Under 2.5 Goals, BTTS, Asian Handicap).
   - **US & Global Team Sports**:
     - **Basketball (NBA, NCAA, EuroLeague, WNBA)**: Regulation clock format (4x12m Quarters vs. 2x20m Halves), Playoff Series context, Point Spread & Total Points O/U.
     - **American Football (NFL, NCAA College Football, CFL, UFL)**: Key spread numbers (±3.0 Field Goal, ±7.0 Touchdown), Total Points O/U, Stadium Dome vs. Outdoor Wind Speed, Precipitation %, Temperature & Barometric Altitude.
     - **Ice Hockey (NHL, NCAA, KHL, AHL)**: Puck Line (±1.5 Goals) & Total Goals O/U.
     - **Baseball (MLB, NCAA, NPB, KBO)**: Run Line (±1.5 Runs), Total Runs O/U, Ballpark Wind Speed/Direction, Humidity, Temperature & Roof status.

2. **`02 TRIGGER` — Live Telemetry, Scoreboard States & Mathematical Edge (`AND` Gate)**:
   - Evaluates real-time play-by-play states, optical match telemetry, and de-vigged probability divergences:
   - **Quantitative Edge (`+EV`)**: Minimum positive Expected Value gap (`exact_edge_pct`) between binary contract price (`0¢–100¢`) and de-vigged fair reference probability, with anti-noise persistence timers (`edge_persistence_sec`).
   - **Tennis Live Telemetry**: Set Score Dynamics (e.g., Favorite loses 1st Set comeback dip); Live Service Telemetry (1st Serve %, 2nd Serve points won %, Aces, Double Faults, Return points won % over current set or rolling 3 games); Break Point (`0-40`/`15-40`) & `6-6` Tie-Break inflection triggers; Medical Timeout (MTO) price spikes & wind gust shocks; Point-level Markov Chain hold probability delta & Level-2 Order Book Bid/Ask imbalance.
   - **Soccer Live Telemetry**: Live score state (e.g., Favorite concedes opening `0-1` goal dip before minute 70); Live Expected Goals (`xG`) differential (`Target xG - Opponent xG`); Unrewarded Attacking Pressure (`xG - Goals >= 0.75`); Ball Possession %, Shots on Target, Corner Kicks, Goalkeeper Saves forced, Key Passes, Passing Accuracy %, Penalty-Box Crosses, and Opponent Yellow/Red Cards.
   - **Basketball Live Telemetry**: Live point margin & scoring run dips, Quarter/Half clock windows & Halftime breaks, 3-Pointers made, 2-Pointers made, Free-Throw %, Timeouts remaining, and Team Fouls.
   - **American Football Live Telemetry**: Live score margin (1–3 pt Field Goal deficit or 4–8 pt Touchdown deficit), Quarter & Two-Minute Warning windows, Timeouts remaining, Drive/Possession dominance, and Opponent Penalties.
   - **Ice Hockey Live Telemetry**: Live goal differential, 20-minute Period & Intermission windows, Power-Play goals, 2-Minute Minor Penalties, and Shot/Attack dominance.
   - **Baseball Live Telemetry**: Live run differential and Inning windows (Early 1–3, Middle 4–6, Late 7–9).

3. **`03 ORDER` — Position Sizing, Microstructure & Execution Routing**:
   - **Capital Allocation**: Fixed USD stake, % of Bot Bankroll, or Fractional Kelly Criterion (`0.25x Quarter-Kelly`, `0.50x Half-Kelly`, `1.00x Full-Kelly`) scaled dynamically to mathematical edge.
   - **Contract Selection & Hedging**: Buy YES, Buy NO, or Auto-Side EV selection; Tennis current-set derivative hedging (`hedge_ratio_pct`); Soccer 3-Way Draw (`X`) hedge (`draw_hedge_ratio_pct`) to construct synthetic Double Chance (`1X` / `X2`) exposure.
   - **Order Book Microstructure**: Maker resting Limit Orders (`0% fee`, configurable cent offset, Time-in-Force `GTC`/`30s`/`120s`/`IOC`, chase tick limit) vs. Taker instant Market Orders (with `max_slippage_cents` protection); DCA ladder scaling (`dca_price_step_cents`, cooldown timers); Liquidity & Spread Guardrails (`max_spread_cents`, `min_top3_depth_usd`, `max_book_depth_pct`).

4. **`04 EXIT` — Automated Profit Targets, Game-State Cashouts & Circuit Breakers (`OR` Race Condition)**:
   - **Quantitative Exits**: Odds Convergence early cash-out (`convergence_residual_pct`), Take-Profit (`+% ROI` with partial scaling), Anti-Wick Stop-Loss (`-% ROI` with `sl_grace_period_sec` delay to ignore momentary 1-second book spikes), and Dynamic Trailing Stops (`trailing_offset_cents`, Match Point auto-cashout).
   - **Sport-Specific In-Play Exits**:
     - *Soccer*: Goal Scored Spike Exit (`+1`/`+2` goal lead), Target Team Red Card emergency exit, 85th-minute stoppage-time theta-decay cash-out.
     - *Basketball*: Scoring Run Lead (`+8 pts`), Halftime Cash-Out, Q4 Clutch Protection, Blowout Stop-Loss (`-18 pts`).
     - *American Football*: Touchdown Lead Cash-Out (`+7 pts`), Two-Score Cushion (`+10 pts`), Halftime Cash-Out, Two-Touchdown Deficit Stop (`-14 pts`).
     - *Ice Hockey*: `+1`/`+2` Goal Lead Cash-Out, Period Intermission Cash-Out, 3rd Period Empty-Net Volatility Protection.
     - *Baseball*: `+2` Run Lead Cash-Out, 5th-Inning (`First-5 / F5`) Starter Lock, Late-Inning Closer Protection, `-4` Run Bullpen Blowup Stop.
   - **Account Risk Circuit Breakers**: Rolling 2-hour order rate limiters (`max_orders_per_2h`), per-match entry caps, post-loss cooldowns, max consecutive losses pause, and 24-hour Daily Drawdown halt (`max_daily_drawdown_pct`).

### 2. Live Radar (`/radar`)
Real-time multi-sport scanner comparing binary contract pricing (`0¢–100¢`) against de-vigged fair market probabilities across Tennis, Soccer, NBA, NFL, NHL, and MLB. Includes instant filtering for positive mathematical edge (`Only show positive edge`), live scores, order-book spreads, and one-click inspection.

### 3. Cognitive Telemetry Logs & Paper-Trading Leaderboard (`/leaderboard`)
Every running bot outputs transparent, real-time cognitive telemetry logs explaining each evaluation cycle (which Target filters matched, live Trigger telemetry values, Order book fill prices, and Exit resolution). The public Leaderboard ranks simulated bots by verified paper-trading ROI, realized vs. mark-to-market PnL, win rate, and drawdown control.

---

## Key Public URLs

- [Home & Overview](https://starkov-app.vercel.app/home): Interactive overview of the Starkov sports prediction sandbox.
- [Bot Studio (MindMap Builder)](https://starkov-app.vercel.app/bots): Visual 4-pillar strategy builder (`01 TARGET`, `02 TRIGGER`, `03 ORDER`, `04 EXIT`) with pre-built blueprints (*Clay 1st-Set Dip Buyer*, *xG Equalizer Scalper*).
- [Live Radar (+EV Scanner)](https://starkov-app.vercel.app/radar): Real-time multi-sport probability divergence and telemetry radar.
- [Leaderboard (Strategy Proof)](https://starkov-app.vercel.app/leaderboard): Verified paper-trading performance rankings and bot telemetry metrics.
- [Technical Documentation](https://starkov-app.vercel.app/doc): Complete parameter reference, order-book microstructure math, de-vigging formulas, and bot blueprints.
- [Core Concepts & FAQ (Q&A Reference)](https://starkov-app.vercel.app/doc?section=faq): Direct questions and mathematical answers on +EV calculation, vig removal, Maker/Taker execution, Fractional Kelly sizing, live telemetry, and sandbox compliance.
- [Pricing Plans](https://starkov-app.vercel.app/pricing): Free, Pro, and Ultra simulation tiers.
- [Legal, Terms & Compliance](https://starkov-app.vercel.app/legal): Terms of Service, Privacy Policy, and SaaS Simulation Disclaimer.
- [Full Technical Reference for LLMs](https://starkov-app.vercel.app/llms-full.txt): Extended technical specification of all parameters and quantitative formulas.