Betting Systems Schemas

Comprehensive schemas for odds management, market adjustments, and trading operations.

System Architecture

OddsAdjustment Schema

The core schema for all odds and line movements.

Schema Visualization

Stakeholder Types

Type	Description	Permissions
`system_automation`	AI/ML automated systems	Full access, no approval
`market_maker`	Professional market makers	Full access, audit logged
`sportsbook_trader`	Sportsbook trading desk	Trade execution only
`trader`	General trader	Standard trade access
`professional_trader`	Verified pro trader	Enhanced limits
`market_researcher`	Research analyst	Read + propose changes
`league_admin`	League administrator	Read + league-specific

Adjustment Types

Line Movement - Adjust point spreads or totals

{
  "adjustment_type": "line_movement",
  "parameters": {
    "adjustment_amount": 0.5,
    "adjustment_direction": "up",
    "target_value": -3.5,
    "market_type": "spread"
  }
}

Common reasons:

Heavy one-sided action
Sharp money detection
Injury news
Weather changes

Risk Assessment Schema

Risk Components

Component	Range	Description
`risk_score`	0.0 - 1.0	Overall risk assessment
`exposure_change`	$ value	Net exposure delta
`profit_impact`	$ value	Expected P&L change
`liquidity_impact`	0.0 - 1.0	Market depth effect
`volatility_impact`	0.0 - 1.0	Price stability effect

Risk Calculation Flow

Audit Trail Schema

Complete tracking for compliance and analysis.

Audit Entry Structure

{
  "audit_trail": [
    {
      "stakeholder_id": "draftkings_trader_001",
      "action": "line_movement",
      "reasoning": "Position management adjustment - heavy favorite exposure",
      "timestamp": "2025-11-05T14:30:00Z",
      "previous_value": -3.0,
      "new_value": -3.5,
      "approval_chain": ["auto_approved"]
    },
    {
      "stakeholder_id": "system_automation",
      "action": "risk_check",
      "reasoning": "Automated risk validation passed",
      "timestamp": "2025-11-05T14:30:01Z",
      "risk_score": 0.18
    }
  ]
}

Audit Timeline

Approval Workflow

Approval Thresholds

Condition	Auto-Approve	Review Required
Line movement	< 1 point	>= 1 point
Juice change	< 5 cents	>= 5 cents
Exposure impact	< $10K	>= $10K
Risk score	< 0.5	>= 0.5
Market suspension	N/A	Always

Complete Example

{
  "action_id": "odds_adj_20251105_001",
  "stakeholder_id": "market_researcher_001",
  "stakeholder_type": "market_researcher",
  "market_event": "nfl_week_10_patriots_bills",
  "adjustment_type": "line_movement",
  "parameters": {
    "adjustment_amount": 0.5,
    "adjustment_direction": "up",
    "target_value": -3.5,
    "market_type": "spread"
  },
  "reasoning": "Heavy Patriots money line exposure. Moving line to balance action and reduce risk.",
  "confidence_score": 0.92,
  "risk_assessment": {
    "risk_score": 0.18,
    "exposure_change": -25000,
    "profit_impact": 1800,
    "liquidity_impact": 0.12,
    "volatility_impact": 0.08
  },
  "audit_trail": [
    {
      "stakeholder_id": "draftkings_trader_001",
      "action": "line_movement",
      "reasoning": "Position management adjustment",
      "timestamp": "2025-11-05T14:30:00Z"
    }
  ],
  "timestamp": "2025-11-05T14:30:00Z",
  "effective_time": "2025-11-05T14:35:00Z",
  "approval_required": false,
  "approval_status": "auto_approved"
}

API Endpoints

POST /v1/odds/adjustment - Submit adjustment
GET /v1/odds/market/{event_id} - Get current market
GET /v1/odds/audit/{action_id} - Get audit trail
WS /v1/odds/stream - Real-time updates

See Trader Guide for integration details.

Related Schemas

Leagues - League and event schemas
Sports - Team and player schemas
Schema Registry - Complete schema listing

Leagues & Organizations AlertStatus