📈 Trends

Trends Object

[
  {
    "id": "TRND_3f1a7c8e4b2d4e9a8c1f5d6b7e8a9c0d",
    "name": "Over 21.5 Points",
    "detail": "Jayson Tatum has gone over 21.5 points in 8 of his last 10 games, averaging 27.4 points per game over that span.",
    "confidence": 87.42,
    "player": {
      "id": "PLYR_fef8f29544ce487c91b23eff993abcd5",
      "sportsdataioId": "20001829",
      "oddsjamId": "944B6D4B694A",
      "sportradarId": "98136da3-452f-49dc-a794-1ee9c76443f2",
      "firstName": "Jayson",
      "lastName": "Tatum",
      "sportId": "SPRT_basketball",
      "fullName": "Jayson Tatum",
      "headshot": "https://player-headshots-sharpsports.s3.us-west-2.amazonaws.com/PLYR_fef8f29544ce487c91b23eff993abcd5.png",
      "position": "SF"
    },
    "team": {
      "id": "TEAM_0bea24fff0ba45a6ba2f88b0217d224e",
      "name": "Celtics",
      "fullName": "Boston Celtics",
      "abbr": "BOS",
      "logo": "https://team-logos-sharpsports.s3.us-east-1.amazonaws.com/NBA/Boston_Celtics.svg"
    },
    "event": {
      "id": "EVNT_037ada1a90b14c4fa164858b4dbfe9d9",
      "sport": "Basketball",
      "league": "NBA",
      "name": "Atlanta Hawks @ Boston Celtics",
      "nameSpecial": null,
      "startTime": "2025-01-19T00:00:00Z",
      "sportId": "SPRT_basketball",
      "leagueId": "LGUE_nba"
    },
    "marketSelection": {
      "id": "MRKT_a1b2c3d4e5f6789012345abcdef67890",
      "type": "PlayerProp",
      "event": "EVNT_037ada1a90b14c4fa164858b4dbfe9d9",
      "segment": "SEGM_M",
      "proposition": "Points",
      "position": "Over",
      "metric": "METR_points",
      "marketOffer": "MOFR_1234567890abcdef1234567890abcdef",
      "market": "MRKT_9876543210fedcba9876543210fedcba"
    },
    "metadata": {
      "line": 21.5,
      "L5": {
        "hits": 4,
        "hitPerc": 80.0
      },
      "L10": {
        "hits": 8,
        "hitPerc": 80.0
      },
      "L15": {
        "hits": 11,
        "hitPerc": 73.33
      },
      "L20": {
        "hits": 14,
        "hitPerc": 70.0
      },
      "hitChart": [
        true, false, true, true, true, false, true, true, true, false, true, true, false, true, true
      ],
      "hitChartPerc": 73.33
    }
  }
]

Endpoints

📈 trends list

Array Structure

The response is an array of trend objects. Each object represents a noteworthy player-prop market for an upcoming event, scored by recent performance and contextual factors. Only trends whose underlying market selection is still available and whose data was refreshed in the last 48 hours are returned.

Trend Object

Each trend captures a player-prop opportunity along with the player, team, event, and underlying market selection it relates to, plus statistical metadata and a natural-language insight.

id (string)

Unique trend identifier with format TRND_*.


name (string)

Short label describing the trend, e.g. "Over 21.5 Points". Constructed from position, line, and metric name.


detail (string|null)

Natural-language insight describing the trend. Generated by the Pine insight service; may be null if generation failed.


confidence (number)

Normalized confidence score (roughly 0–100). Higher values indicate a stronger signal based on hit rate, defense-vs-position rank, and (for MLB) park factor.


player (object)

Player the trend is about.

id (string)

Unique player identifier with format PLYR_*.

sportsdataioId (string)

External identifier from SportsData.io API for this player.

oddsjamId (string)

External identifier from OddsJam API for this player.

sportradarId (string)

External identifier from Sportradar API for this player.

firstName (string)

Player's first name.

lastName (string)

Player's last name.

sportId (string)

Sport identifier with format SPRT_*.

fullName (string)

Player's complete name (firstName + lastName).

headshot (string)

URL to the player's headshot image hosted on S3.

position (string|null)

Player's position derived from the most recent PlayerGameData record. null when no positional data is available.


team (object)

Team the player is rostered on.

id (string)

Unique team identifier with format TEAM_*.

name (string)

Team short name (e.g., "Celtics").

fullName (string)

Team's complete name including city (e.g., "Boston Celtics").

abbr (string)

Standard team abbreviation (e.g., "BOS").

logo (string|null)

URL to the team's SVG logo on S3. null if a logo cannot be resolved.


event (object)

Event the trend's underlying market selection belongs to.

id (string)

Unique event identifier with format EVNT_*.

sport (string)

Sport name (e.g., "Basketball").

league (string)

League name (e.g., "NBA").

name (string)

Event name in format "Away Team @ Home Team".

nameSpecial (string|null)

Special event designation or null for regular games.

startTime (string)

ISO 8601 formatted start time of the event.

sportId (string)

Sport identifier with format SPRT_*.

leagueId (string)

League identifier with format LGUE_*.


marketSelection (object)

The market selection (player-prop side) the trend is for.

id (string)

Unique market selection identifier with format MRKT_*.

type (string)

Market selection type (e.g., "PlayerProp").

event (string)

Identifier of the associated event (EVNT_*).

segment (string)

Segment identifier (e.g., "SEGM_M" for the full match).

proposition (string)

Proposition label (e.g., "Points", "Rebounds").

position (string)

Side of the market — typically "Over" or "Under".

metric (string)

Metric identifier (METR_*).

marketOffer (string)

Identifier of the parent market offer (MOFR_*).

market (string)

Identifier of the parent market (MRKT_*).


metadata (object|null)

Statistical context for the trend. null if no PlayerGameData was available.

line (number)

The line the trend is evaluated against (mode line across books).

L5 (object|null)

Last-5-games stats, or null if the player has fewer than 5 qualifying games.

hits (integer)

Number of games (out of 5) where the player's value exceeded the line.

hitPerc (number)

Hit percentage (0–100), rounded to 2 decimals.

L10 (object|null)

Last-10-games stats — same shape as L5. null if fewer than 10 games.

L15 (object|null)

Last-15-games stats — same shape as L5. null if fewer than 15 games.

L20 (object|null)

Last-20-games stats — same shape as L5. null if fewer than 20 games.

hitChart (array of booleans)

Per-game hit history covering up to the last 15 qualifying games, oldest first. Each entry is true if the player's value exceeded the line in that game.

hitChartPerc (number)

Percentage of true entries in hitChart (0–100), rounded to 2 decimals.