Picks & Analytics API Endpoints

Overview

Endpoints for value picks, predictions, trends, line movements, and analytics data.

Endpoint Summary

Endpoint Method Auth Description
/v1/valuepicks GET None Get value picks
/v1/parlays GET None Get parlay picks
/v1/valueprops GET None Get value prop picks
/v1/matchprops GET None Get match prop picks
/v1/matchtrendssummary GET None Get match trends summary
/v1/matchpicks GET None Get match picks by ID
/v1/matchpicks/{pickId}/comments/trend GET None Get trend comments
/v1/matches/{matchId}/pickprediction GET None Get pick predictions
/v1/matches/{matchId}/linemovement GET None Get line movements
/v1/matches/{matchId}/lineperformance GET None Get line performance
/v2/matches/{matchId}/lineperformance GET None Get line performance v2
/v1/matches/{matchId}/injuries GET None Get match injuries
/v1/injuries GET None Get injuries list
/v1/matches/{matchId}/headtohead GET None Get head-to-head data
/v1/matches/{matchId}/summary GET None Get match summary
/v1/matches-summaries GET None Get multiple match summaries
/v1/matches/search GET None Search matches
/v1/matches/search/files GET None Search match files

Value Picks Endpoints

1. GET /v1/valuepicks

Description: Retrieves value picks with grades and recommendations.

Query Parameters:

Parameter Type Description
LeagueId long[] Filter by league IDs
Date DateTime Specific date
ValueGrade string[] Filter by grade (A+, A, B, etc.)
IncludeGrades bool Include grade details
Limit int Maximum results

Response: IEnumerable<ValuePickV2>

[
  {
    "matchId": 12345,
    "pickId": 67890,
    "pickType": "spread",
    "side": "away",
    "team": "Dallas Cowboys",
    "line": -3.5,
    "odds": -110,
    "valueGrade": "A+",
    "valueScore": 92,
    "confidence": 0.85,
    "reasoning": "Strong road record...",
    "matchTime": "2025-11-29T21:25:00Z"
  }
]

Response Fields:

Field Type Description
matchId long Match identifier
pickId long Pick identifier
pickType string Type: spread, moneyline, total
side string Pick side: home, away, over, under
team string Team name
line double Line/spread value
odds int American odds
valueGrade string Letter grade (A+, A, B, C, etc.)
valueScore int Numeric value score (0-100)
confidence double Confidence level (0-1)
reasoning string Pick reasoning
matchTime DateTime Match start time

2. GET /v1/parlays

Description: Retrieves parlay (multi-bet) recommendations.

Query Parameters:

Parameter Type Description
LeagueId long[] Filter by league
Date DateTime Parlay date

Response: IEnumerable<ParlayValuePick>

[
  {
    "parlayId": 12345,
    "legs": [
      {
        "matchId": 67890,
        "team": "Cowboys",
        "pickType": "spread",
        "line": -3.5,
        "odds": -110
      },
      {
        "matchId": 67891,
        "team": "Eagles",
        "pickType": "moneyline",
        "odds": -150
      }
    ],
    "totalOdds": "+250",
    "valueGrade": "B+",
    "confidence": 0.72
  }
]

3. GET /v1/valueprops

Description: Retrieves player prop value picks.

Query Parameters:

Parameter Type Description
LeagueId long[] Filter by league
Date DateTime Prop date
MatchId long Filter by match

Response: ValuePropsResponse

{
  "valueProps": [
    {
      "playerId": 456,
      "playerName": "Dak Prescott",
      "propType": "passing_yards",
      "line": 275.5,
      "pick": "over",
      "odds": -115,
      "valueGrade": "A",
      "projection": 295
    }
  ]
}

4. GET /v1/matchprops

Description: Retrieves match-level props.

Query Parameters:

Parameter Type Description
MatchId long Match ID

Response: MatchPropsResponse

5. GET /v1/matchtrendssummary

Description: Retrieves betting trends summary for matches.

Query Parameters:

Parameter Type Description
MatchIds long[] Match IDs

Response: MatchTrendsSummaryResponse

{
  "matchTrendsSummary": [
    {
      "matchId": 12345,
      "publicSpreadPct": 65,
      "publicMoneylinePct": 72,
      "publicTotalPct": 48,
      "sharpAction": "away",
      "lineMovement": "away -3 to -3.5"
    }
  ]
}

Match Picks Endpoints

6. GET /v1/matchpicks

Description: Retrieves pick details by ID.

Query Parameters:

Parameter Type Description
id long[] Pick IDs to retrieve

Response: List<MatchPick>

7. GET /v1/matchpicks/{pickId}/comments/trend

Description: Retrieves trend analysis comments for a pick.

Path Parameters:

Response: MatchPickCommentResponse

{
  "comment": "The Cowboys are 8-2 ATS in their last 10 road games..."
}

Analytics Endpoints

8. GET /v1/matches/{matchId}/pickprediction

Description: Retrieves AI-powered pick predictions for a match.

Path Parameters:

Response: PickPredictionResponse

{
  "matchId": 12345,
  "predictions": [
    {
      "pickType": "spread",
      "prediction": "Cowboys -3.5",
      "confidence": 0.78,
      "reasoning": "Model factors favor Dallas..."
    }
  ]
}

9. GET /v1/matches/{matchId}/linemovement

Description: Retrieves line movement history for a match.

Path Parameters:

Response: LineMovementResponse

{
  "matchId": 12345,
  "movements": [
    {
      "timestamp": "2025-11-29T10:00:00Z",
      "spreadHome": -3.0,
      "total": 47.5,
      "mlHome": -155,
      "mlAway": 135
    },
    {
      "timestamp": "2025-11-29T15:00:00Z",
      "spreadHome": -3.5,
      "total": 48.0,
      "mlHome": -165,
      "mlAway": 140
    }
  ]
}

10. GET /v1/matches/{matchId}/lineperformance

Description: Retrieves historical line performance data.

Path Parameters:

Response: LinePerformanceResponse

11. GET /v2/matches/{matchId}/lineperformance

Description: Enhanced line performance with additional metrics.

Path Parameters:

Response: LinePerformanceResponseV2

12. GET /v1/matches/{matchId}/injuries

Description: Retrieves injury report for a specific match.

Path Parameters:

Response: InjuriesResponse

{
  "matchId": 12345,
  "injuries": [
    {
      "playerId": 456,
      "playerName": "Player Name",
      "team": "Cowboys",
      "position": "WR",
      "status": "Questionable",
      "injury": "Hamstring",
      "lastUpdate": "2025-11-28"
    }
  ]
}

13. GET /v1/injuries

Description: Retrieves all current injuries across leagues.

Query Parameters:

Parameter Type Description
LeagueId long[] Filter by league
TeamId long[] Filter by team

Response: InjuriesResponse

14. GET /v1/matches/{matchId}/headtohead

Description: Retrieves head-to-head comparison data.

Path Parameters:

Response: List<HeadToHeadComparisonItem>

[
  {
    "category": "Points Per Game",
    "team1Value": 28.5,
    "team2Value": 24.3,
    "advantage": "team1"
  },
  {
    "category": "Yards Per Game",
    "team1Value": 375.2,
    "team2Value": 358.1,
    "advantage": "team1"
  }
]

15. GET /v1/matches/{matchId}/summary

Description: Retrieves match analysis summary.

Path Parameters:

Response: MatchSummaryResponse

16. GET /v1/matches-summaries

Description: Retrieves summaries for multiple matches.

Query Parameters:

Parameter Type Description
MatchIds long[] Match IDs

Response: IEnumerable<MatchSummaryResponse>

Search Endpoints

17. GET /v1/matches/search

Description: Search for matches by query string.

Query Parameters:

Parameter Type Description
SearchQuery string Search text
Limit int Maximum results

Response: IEnumerable<SearchResult>

18. GET /v1/matches/search/files

Description: Search for match-related files/documents.

Query Parameters:

Parameter Type Description
SearchQuery string Search text

Response: IEnumerable<SearchFileResult>

Examples

Get Today's Value Picks

curl -X GET "https://api.example.com/v1/valuepicks?Date=2025-11-29&IncludeGrades=true"

Get A+ Grade Picks Only

curl -X GET "https://api.example.com/v1/valuepicks?ValueGrade=A%2B&LeagueId=1"

Get Line Movement for Match

curl -X GET "https://api.example.com/v1/matches/12345/linemovement"

Get Head-to-Head Stats

curl -X GET "https://api.example.com/v1/matches/12345/headtohead"

Search for Cowboys Games

curl -X GET "https://api.example.com/v1/matches/search?SearchQuery=Cowboys"

Related Endpoints