API Reference
  1. Odditt B2B Public API
  2. Trends

Get mixed flows (paginated)

post
https://api.odditt.com/v1/trends/mixed-flows

Returns a paginated set of mixed flows matching the supplied filters.

This endpoint also accepts the HTTP QUERY method. A QUERY request takes
the same request body and returns the same response as POST. QUERY is a
safe, idempotent method intended for read operations that need a request
body, so its responses are cacheable. POST remains fully supported and is
the recommended choice for clients whose HTTP tooling cannot issue QUERY.
Using QUERY requires that your API key's permissions allow the QUERY
method for this endpoint; a key permitted only for POST will be rejected
when it sends QUERY.

Example response

{
  "page": 1,
  "page_size": 20,
  "records": [
    {
      "american_odds_value": "-110",
      "away_score": null,
      "away_team_display_name": "New York Liberty W",
      "away_team_id": 9250,
      "betting_market_display_name": "Total Points",
      "betting_market_id": 557,
      "betting_market_position_display_name": "Under",
      "betting_market_position_id": 5,
      "condition_emoji_payload": [],
      "dark_mode_background_url": null,
      "decimal_odds_value": 1.91,
      "default_logo_url": "https://d1aarzeg4vkb0r.cloudfront.net/teams/9250.png",
      "default_split": "H2H",
      "default_split_percentage": 83,
      "display_json": {
        "colors": [
          "green",
          "green",
          "green"
        ],
        "denominator": 24,
        "narrative": "There have been less than 174.5 total points scored in 20 of the last 24 New York W games vs. Phoenix W",
        "numerator": 20,
        "tagline": "83% in the last 24 games against PHO",
        "win_percentage": 83
      },
      "display_line_value": "174.5",
      "display_name_full": "New York Liberty W",
      "event_betting_market_position_display_name": "Under 174.5 - Total Points",
      "event_betting_market_position_id": 210382651,
      "event_id": 3426321,
      "event_name_short": "NYL @ PHO",
      "event_start_time_utc": "2026-08-01T19:00:00+00:00",
      "event_status": null,
      "exact_score": null,
      "fact_flow_id": 570463133,
      "fact_flow_type": "base",
      "flow_type": "fact_flow",
      "fractional_odds_value": "100/110",
      "game_state": null,
      "graph_bars_have_labels": true,
      "graph_maximum_line_value": 174.5,
      "graph_minimum_line_value": null,
      "graph_type_name": "over_under",
      "home_score": null,
      "home_team_display_name": "Phoenix Mercury W",
      "home_team_id": 9249,
      "league_id": 133,
      "light_mode_background_url": null,
      "line_value": 174.5,
      "odds_implied_probability": 0.524,
      "payout_multiplier": 0.909,
      "player_id": null,
      "sport_id": 2,
      "suggested_border_color_1": null,
      "suggested_border_color_2": null,
      "team_id": 9250,
      "tournament_type_id": null
    },
    {
      "american_odds_value": "-200",
      "away_score": null,
      "away_team_display_name": "Seattle Storm W",
      "away_team_id": 9252,
      "betting_market_display_name": "Points Scored",
      "betting_market_id": 316,
      "betting_market_position_display_name": "Over",
      "betting_market_position_id": 4,
      "dark_mode_background_url": null,
      "decimal_odds_value": 1.5,
      "default_logo_url": "https://d1aarzeg4vkb0r.cloudfront.net/players/516173.png",
      "display_json": {
        "1": {
          "emoji_json": [
            "1F31F"
          ],
          "emoji_unicode": "1F31F",
          "narrative": "The WNBA is a popular league",
          "source_type": "league"
        },
        "2": {
          "emoji_json": [
            "26CF FE0F",
            "0035 FE0F 20E3"
          ],
          "emoji_unicode": "26CF FE0F 0035 FE0F 20E3",
          "narrative": "Canada was selected with the 5th pick in the WNBA draft",
          "source_type": "player"
        },
        "3": {
          "emoji_json": [
            "1F9CD 200D 2642 FE0F",
            "1F1FA 1F1F8"
          ],
          "emoji_unicode": "1F9CD 200D 2642 FE0F 1F1FA 1F1F8",
          "narrative": "Canada is from the United States",
          "source_type": "player"
        }
      },
      "display_line_value": "9.5",
      "display_name_full": "Jordin Canada",
      "event_betting_market_position_display_name": "J. Canada Over 9.5 - Points Scored",
      "event_betting_market_position_id": 210122087,
      "event_id": 3426189,
      "event_name_short": "ATL vs. SEA",
      "event_start_time_utc": "2026-07-31T23:30:00+00:00",
      "event_status": null,
      "exact_score": null,
      "flow_type": "fun_flow",
      "fractional_odds_value": "1/2",
      "fun_flow_id": 548141944,
      "game_state": null,
      "home_score": null,
      "home_team_display_name": "Atlanta Dream W",
      "home_team_id": 10541,
      "league_id": 133,
      "light_mode_background_url": null,
      "line_value": 9.5,
      "odds_implied_probability": 0.667,
      "payout_multiplier": 0.5,
      "player_id": 516173,
      "sport_id": 2,
      "suggested_border_color_1": null,
      "suggested_border_color_2": null,
      "team_id": 10541,
      "tournament_type_id": null
    },
    {
      "american_odds_value": "+1400",
      "away_score": null,
      "dark_mode_background_url": null,
      "decimal_odds_value": 15,
      "event_betting_market_position_ids": [
        210389283,
        210314257
      ],
      "event_id": null,
      "event_start_time_utc": "2026-07-31T23:07:00Z",
      "event_status": null,
      "fact_flow_ids": [
        569896117,
        569845669
      ],
      "fact_flow_parlay_id": 71832777,
      "flow_type": "fact_flow_parlay",
      "flows": [
        {
          "american_odds_value": "+353",
          "away_score": null,
          "away_team_display_name": "Washington Nationals",
          "away_team_id": 9890,
          "betting_market_display_name": "To Hit a Home Run",
          "betting_market_id": 683,
          "betting_market_position_display_name": "Yes",
          "betting_market_position_id": 7,
          "condition_emoji_payload": [
            "1F9F3"
          ],
          "decimal_odds_value": 4.53,
          "default_logo_url": "https://d1aarzeg4vkb0r.cloudfront.net/players/496911.png",
          "default_split": "L20",
          "default_split_percentage": 45,
          "display_json": {
            "colors": [
              "green",
              "red",
              "green"
            ],
            "denominator": 20,
            "narrative": "C. Abrams has hit at least 1 homerun in 9 of the last 20 away games",
            "numerator": 9,
            "tagline": "45% in the last 20 away games",
            "win_percentage": 45
          },
          "display_line_value": null,
          "display_name_full": "CJ Abrams",
          "event_betting_market_position_display_name": "C. Abrams Yes - To Hit a Home Run",
          "event_betting_market_position_id": 210389283,
          "event_id": 3426179,
          "event_name_short": "WSH @ ATL",
          "event_start_time_utc": "2026-07-31T23:15:00+00:00",
          "event_status": null,
          "exact_score": null,
          "fact_flow_id": 569896117,
          "fact_flow_type": "base",
          "flow_type": "fact_flow",
          "fractional_odds_value": "353/100",
          "game_state": null,
          "graph_bars_have_labels": true,
          "graph_maximum_line_value": null,
          "graph_minimum_line_value": null,
          "graph_type_name": "boolean",
          "home_score": null,
          "home_team_display_name": "Atlanta Braves",
          "home_team_id": 9362,
          "league_id": 129,
          "line_value": null,
          "odds_implied_probability": 0.221,
          "payout_multiplier": 3.53,
          "player_id": 496911,
          "sport_id": 4,
          "team_id": 9890,
          "tournament_type_id": null
        },
        {
          "american_odds_value": "+220",
          "away_score": null,
          "away_team_display_name": "St. Louis Cardinals",
          "away_team_id": 9339,
          "betting_market_display_name": "RBIs",
          "betting_market_id": 327,
          "betting_market_position_display_name": "Over",
          "betting_market_position_id": 4,
          "condition_emoji_payload": [
            "1F9F3"
          ],
          "decimal_odds_value": 3.2,
          "default_logo_url": "https://d1aarzeg4vkb0r.cloudfront.net/players/514834.png",
          "default_split": "SZN",
          "default_split_percentage": 50,
          "display_json": {
            "colors": [
              "red",
              "green",
              "red"
            ],
            "denominator": 48,
            "narrative": "J. Walker has had more than 0.5 runs batted in in 24 of 48 away games this season",
            "numerator": 24,
            "tagline": "50% in 48 away games this season",
            "win_percentage": 50
          },
          "display_line_value": "0.5",
          "display_name_full": "Jordan Walker",
          "event_betting_market_position_display_name": "J. Walker Over 0.5 - RBIs",
          "event_betting_market_position_id": 210314257,
          "event_id": 3426175,
          "event_name_short": "STL @ TOR",
          "event_start_time_utc": "2026-07-31T23:07:00+00:00",
          "event_status": null,
          "exact_score": null,
          "fact_flow_id": 569845669,
          "fact_flow_type": "base",
          "flow_type": "fact_flow",
          "fractional_odds_value": "220/100",
          "game_state": null,
          "graph_bars_have_labels": true,
          "graph_maximum_line_value": null,
          "graph_minimum_line_value": 0.5,
          "graph_type_name": "over_under",
          "home_score": null,
          "home_team_display_name": "Toronto Blue Jays",
          "home_team_id": 9349,
          "league_id": 129,
          "line_value": 0.5,
          "odds_implied_probability": 0.313,
          "payout_multiplier": 2.2,
          "player_id": 514834,
          "sport_id": 4,
          "team_id": 9339,
          "tournament_type_id": null
        }
      ],
      "fractional_odds_value": "14/1",
      "game_state": null,
      "home_score": null,
      "league_id": 129,
      "light_mode_background_url": null,
      "odds_implied_probability": 0.067,
      "parlay_name": "Round 1 Slate🔍🎯",
      "parlay_subtitle": "BETS ON ROUND 1 PICKS",
      "payout_multiplier": 14,
      "player_id": null,
      "sport_id": 4,
      "suggested_border_color_1": null,
      "suggested_border_color_2": null,
      "team_id": null,
      "tournament_type_id": null
    },
    {
      "american_odds_value": "+1145",
      "away_score": null,
      "dark_mode_background_url": "https://static.odditt.com/card-background-images/basketball-dark.png",
      "decimal_odds_value": 12.454,
      "event_betting_market_position_ids": [
        210087030,
        210409384,
        210419733
      ],
      "event_id": null,
      "event_start_time_utc": "2026-08-01T02:00:00Z",
      "event_status": null,
      "flow_type": "fun_flow_parlay",
      "flows": [
        {
          "american_odds_value": "+122",
          "away_score": null,
          "away_team_display_name": "Indiana Fever W",
          "away_team_id": 9254,
          "betting_market_display_name": "Points Scored",
          "betting_market_id": 316,
          "betting_market_position_display_name": "Over",
          "betting_market_position_id": 4,
          "decimal_odds_value": 2.22,
          "default_logo_url": "https://d1aarzeg4vkb0r.cloudfront.net/players/514209.png",
          "display_json": {
            "1": {
              "emoji_json": [
                "1F4C5",
                "0032 FE0F 20E3",
                "0030 FE0F 20E3"
              ],
              "emoji_unicode": "1F4C5 0032 FE0F 20E3 0030 FE0F 20E3 0032 FE0F 20E3 0032 FE0F 20E3",
              "narrative": "Engstler was selected in the 2022 WNBA draft",
              "source_type": "player"
            },
            "2": {
              "emoji_json": [
                "1F476",
                "0032 FE0F 20E3",
                "0030 FE0F 20E3"
              ],
              "emoji_unicode": "1F476 0032 FE0F 20E3 0030 FE0F 20E3 0030 FE0F 20E3 0030 FE0F 20E3",
              "narrative": "Engstler was born in 2000",
              "source_type": "player"
            },
            "3": {
              "emoji_json": [
                "1F9CD 200D 2642 FE0F",
                "1F5FD",
                "1F34E"
              ],
              "emoji_unicode": "1F9CD 200D 2642 FE0F 1F5FD 1F34E",
              "narrative": "Engstler is from New York",
              "source_type": "player"
            }
          },
          "display_line_value": "9.5",
          "display_name_full": "Emily Engstler",
          "event_betting_market_position_display_name": "E. Engstler Over 9.5 - Points Scored",
          "event_betting_market_position_id": 210087030,
          "event_id": 3426320,
          "event_name_short": "POR vs. IND",
          "event_start_time_utc": "2026-08-01T02:00:00+00:00",
          "event_status": null,
          "exact_score": null,
          "flow_type": "fun_flow",
          "fractional_odds_value": "122/100",
          "fun_flow_id": 548256626,
          "game_state": null,
          "home_score": null,
          "home_team_display_name": "Portland Fire W",
          "home_team_id": 17108,
          "league_id": 133,
          "line_value": 9.5,
          "odds_implied_probability": 0.45,
          "payout_multiplier": 1.22,
          "player_id": 514209,
          "sport_id": 2,
          "team_id": 17108,
          "tournament_type_id": null
        },
        {
          "american_odds_value": "+107",
          "away_score": null,
          "away_team_display_name": "New York Liberty W",
          "away_team_id": 9250,
          "betting_market_display_name": "Points Scored",
          "betting_market_id": 316,
          "betting_market_position_display_name": "Over",
          "betting_market_position_id": 4,
          "decimal_odds_value": 2.07,
          "default_logo_url": "https://d1aarzeg4vkb0r.cloudfront.net/players/516285.png",
          "display_json": {
            "1": {
              "emoji_json": [
                "1F31F"
              ],
              "emoji_unicode": "1F31F",
              "narrative": "The WNBA is a popular league",
              "source_type": "league"
            },
            "2": {
              "emoji_json": [
                "1F476",
                "0031 FE0F 20E3",
                "0039 FE0F 20E3"
              ],
              "emoji_unicode": "1F476 0031 FE0F 20E3 0039 FE0F 20E3 0039 FE0F 20E3 0034 FE0F 20E3",
              "narrative": "Jones was born in 1994",
              "source_type": "player"
            },
            "3": {
              "emoji_json": [
                "0033 FE0F 20E3",
                "0035 FE0F 20E3"
              ],
              "emoji_unicode": "0033 FE0F 20E3 0035 FE0F 20E3",
              "narrative": "Jones wears jersey number 35",
              "source_type": "player"
            }
          },
          "display_line_value": "14.5",
          "display_name_full": "Jonquel Jones",
          "event_betting_market_position_display_name": "J. Jones Over 14.5 - Points Scored",
          "event_betting_market_position_id": 210409384,
          "event_id": 3426321,
          "event_name_short": "NYL @ PHO",
          "event_start_time_utc": "2026-08-01T19:00:00+00:00",
          "event_status": null,
          "exact_score": null,
          "flow_type": "fun_flow",
          "fractional_odds_value": "107/100",
          "fun_flow_id": 548274750,
          "game_state": null,
          "home_score": null,
          "home_team_display_name": "Phoenix Mercury W",
          "home_team_id": 9249,
          "league_id": 133,
          "line_value": 14.5,
          "odds_implied_probability": 0.483,
          "payout_multiplier": 1.07,
          "player_id": 516285,
          "sport_id": 2,
          "team_id": 9250,
          "tournament_type_id": null
        },
        {
          "american_odds_value": "+171",
          "away_score": null,
          "away_team_display_name": "Las Vegas Aces W",
          "away_team_id": 10544,
          "betting_market_display_name": "Points Scored",
          "betting_market_id": 316,
          "betting_market_position_display_name": "Over",
          "betting_market_position_id": 4,
          "decimal_odds_value": 2.71,
          "default_logo_url": "https://d1aarzeg4vkb0r.cloudfront.net/players/516301.png",
          "display_json": {
            "1": {
              "emoji_json": [
                "1F31F"
              ],
              "emoji_unicode": "1F31F",
              "narrative": "The WNBA is a popular league",
              "source_type": "league"
            },
            "2": {
              "emoji_json": [
                "1F9CD 200D 2642 FE0F",
                "1F1FA 1F1F8"
              ],
              "emoji_unicode": "1F9CD 200D 2642 FE0F 1F1FA 1F1F8",
              "narrative": "Gray is from the United States",
              "source_type": "player"
            },
            "3": {
              "emoji_json": [
                "1F9CD 200D 2642 FE0F",
                "1F333",
                "2708 FE0F"
              ],
              "emoji_unicode": "1F9CD 200D 2642 FE0F 1F333 2708 FE0F 1F499 1F608",
              "narrative": "Gray has played for Duke",
              "source_type": "player"
            }
          },
          "display_line_value": "14.5",
          "display_name_full": "Chelsea Gray",
          "event_betting_market_position_display_name": "C. Gray Over 14.5 - Points Scored",
          "event_betting_market_position_id": 210419733,
          "event_id": 3426322,
          "event_name_short": "LVA @ CHI",
          "event_start_time_utc": "2026-08-01T17:00:00+00:00",
          "event_status": null,
          "exact_score": null,
          "flow_type": "fun_flow",
          "fractional_odds_value": "171/100",
          "fun_flow_id": 548290971,
          "game_state": null,
          "home_score": null,
          "home_team_display_name": "Chicago Sky W",
          "home_team_id": 10542,
          "league_id": 133,
          "line_value": 14.5,
          "odds_implied_probability": 0.369,
          "payout_multiplier": 1.71,
          "player_id": 516301,
          "sport_id": 2,
          "team_id": 10544,
          "tournament_type_id": null
        }
      ],
      "fractional_odds_value": "5727/500",
      "fun_flow_ids": [
        548256626,
        548274750,
        548290971
      ],
      "fun_flow_parlay_id": 50798274,
      "game_state": null,
      "home_score": null,
      "league_id": 133,
      "light_mode_background_url": "https://static.odditt.com/card-background-images/basketball-light.png",
      "odds_implied_probability": 0.08,
      "parlay_name": "💰🏀Attack Artists🎨",
      "parlay_subtitle": "PLAYER OFFENSIVE PROPS",
      "payout_multiplier": 11.454,
      "player_id": null,
      "sport_id": 2,
      "suggested_border_color_1": null,
      "suggested_border_color_2": null,
      "team_id": null,
      "tournament_type_id": null
    },
    {
      "american_odds_value": "+384",
      "away_score": null,
      "dark_mode_background_url": "https://static.odditt.com/card-background-images/possible-dark.png",
      "decimal_odds_value": 4.838,
      "event_betting_market_position_ids": [
        210409837,
        210517881
      ],
      "event_id": null,
      "event_start_time_utc": "2026-07-31T23:05:00Z",
      "event_status": null,
      "flow_type": "plain_flow_parlay",
      "fractional_odds_value": "1919/500",
      "game_state": null,
      "home_score": null,
      "league_id": 129,
      "legs": [
        {
          "american_odds_value": "+125",
          "away_score": null,
          "away_team_display_name": "Minnesota Twins",
          "away_team_id": 9355,
          "betting_market_display_name": "Hits + Runs + RBIs",
          "betting_market_id": 281,
          "betting_market_position_display_name": "Over",
          "betting_market_position_id": 4,
          "decimal_odds_value": 2.25,
          "default_logo_url": "https://d1aarzeg4vkb0r.cloudfront.net/players/477032.png",
          "display_line_value": "1.5",
          "display_name_full": "Trevor Larnach",
          "event_betting_market_position_display_name": "T. Larnach Over 1.5 - Hits + Runs + RBIs",
          "event_betting_market_position_id": 210409837,
          "event_id": 3426307,
          "event_name_short": "MIN @ SEA",
          "event_start_time_utc": "2026-08-01T02:10:00+00:00",
          "event_status": null,
          "exact_score": null,
          "fractional_odds_value": "125/100",
          "game_state": null,
          "home_score": null,
          "home_team_display_name": "Seattle Mariners",
          "home_team_id": 9348,
          "league_id": 129,
          "line": "1.5",
          "line_value": 1.5,
          "odds_implied_probability": 0.444,
          "payout_multiplier": 1.25,
          "player_id": 477032,
          "sport_id": 4,
          "team_id": 9355,
          "tournament_type_id": null
        },
        {
          "american_odds_value": "+115",
          "away_score": null,
          "away_team_display_name": "Philadelphia Phillies",
          "away_team_id": 9342,
          "betting_market_display_name": "Total Bases",
          "betting_market_id": 390,
          "betting_market_position_display_name": "Under",
          "betting_market_position_id": 5,
          "decimal_odds_value": 2.15,
          "default_logo_url": "https://d1aarzeg4vkb0r.cloudfront.net/players/515451.png",
          "display_line_value": "0.5",
          "display_name_full": "Christian Encarnacion-Strand",
          "event_betting_market_position_display_name": "C. Encarnacion-Strand Under 0.5 - Total Bases",
          "event_betting_market_position_id": 210517881,
          "event_id": 3426180,
          "event_name_short": "BAL vs. PHI",
          "event_start_time_utc": "2026-07-31T23:05:00+00:00",
          "event_status": null,
          "exact_score": null,
          "fractional_odds_value": "115/100",
          "game_state": null,
          "home_score": null,
          "home_team_display_name": "Baltimore Orioles",
          "home_team_id": 9358,
          "league_id": 129,
          "line": "0.5",
          "line_value": 0.5,
          "odds_implied_probability": 0.465,
          "payout_multiplier": 1.15,
          "player_id": 515451,
          "sport_id": 4,
          "team_id": 9358,
          "tournament_type_id": null
        }
      ],
      "light_mode_background_url": "https://static.odditt.com/card-background-images/possible-light.png",
      "odds_implied_probability": 0.207,
      "parlay_name": "💰🫢⚾Slugger Speculation🏏",
      "parlay_subtitle": "PLAYER BATTING PROPS WITH A MODERATE WIN PROBABILITY",
      "payout_multiplier": 3.838,
      "plain_flow_parlay_id": 16405342,
      "player_id": null,
      "sport_id": 4,
      "suggested_border_color_1": "orange",
      "suggested_border_color_2": "orange",
      "team_id": null,
      "tournament_type_id": null
    }
  ]
}
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
enum

Type of flow to return. 'plain' only returns parlays.

Allowed:
string
enum

Filter by bet type. If omitted, returns mixed singles and parlays.

Allowed:
string
enum

Sub-type for fact flows. Defaults to 'base' if omitted.

Allowed:
operator_ids
array of int64s

Filter by operator IDs

operator_ids
operator_keys
array of strings

Filter by operator external keys (e.g. 'draftkings'). Format: {operator_key}. Resolved IDs are merged with operator_ids.

operator_keys
betting_market_ids
array of int64s

Filter by betting market IDs

betting_market_ids
string
enum

Filter by betting market entity type

Allowed:
boolean

When false, exclude alt lines. Defaults to true.

boolean

When true, return only basic trends (omit fact flows with conditions)

boolean

When true, returns operator-specific odds and deeplink URLs (bet_ios_deep_link_url, bet_android_deep_link_url, bet_web_deep_link_url) for each flow. Requires exactly one operator_id in operator_ids.

string
enum

Display mode. dfs rewrites stat lines to MORE/LESS; on the paginated flows endpoints it also auto-filters to over/under player props (entity_type=player, positions [4,5]) unless an entity/position filter is set.

Allowed:
string
enum

Odds display format. Defaults per product_mode (dfs→multiplier, prediction_market→percent, else american).

Allowed:
boolean

When true, the logo fields on each flow and leg (default_logo_url, logo_url_1, logo_url_2) are replaced with cartoon-jersey image URLs derived from the relevant team, player, or league. When false or omitted, the original logo URLs are returned. Defaults to false.

event_ids
array of int64s

Filter by one or more event IDs. Empty array = no filter.

event_ids
sport_ids
array of int64s

Filter by one or more sport IDs. Empty array = no filter.

sport_ids
league_ids
array of int64s

Filter by one or more league IDs. Empty array = no filter.

league_ids
player_ids
array of int64s

Filter by one or more player IDs. Empty array = no filter.

player_ids
team_ids
array of int64s

Filter by one or more team IDs. Empty array = no filter.

team_ids
string

Sport external key (e.g. 'american-football'). Format: {sport_key}. Alternative to sport_id. If both are provided, sport_id takes precedence.

boolean

When true, only return flows for events starting within the next hour. For a custom time window, use event_start_date_from / event_start_date_to instead.

boolean

When true, only return fact flows whose trends have hit 100% of the time (a perfect historical hit rate).

string
enum

Filter by split type (overs or unders)

Allowed:
string
enum

Filter by likelihood category

Allowed:
betting_market_category_ids
array of int64s

Filter by one or more betting market category IDs. Empty array = no filter.

betting_market_category_ids
betting_market_position_ids
array of int64s

Filter by one or more betting market position IDs. Empty array = no filter.

betting_market_position_ids
int64
≥ 1

Filter by focus entity type ID

integer
0 to 100

Maximum hit rate threshold filter (0-100)

double

Maximum implied probability threshold filter

integer
0 to 100

Minimum hit rate threshold filter (0-100)

double

Minimum implied probability threshold filter

string
enum

Filter to trends computed over a team's home or away games only. Omit for all games.

Allowed:
date-time

Filter events starting on or after this value. Accepts a date ('2026-04-19') or full ISO 8601 timestamp ('2026-04-19T00:00:00Z').

date-time

Filter events starting on or before this value. Accepts a date ('2026-04-26') or full ISO 8601 timestamp ('2026-04-26T23:59:59Z').

boolean

When true, permits star sign/horoscope content in the feed. Note: to specifically see horoscope-related content, you must also pass the corresponding tag types (see the tag reference endpoints).

content_tag_type_ids
array of int64s

Filter flows by content tag type IDs. Content tags describe what the flow is about — the thematic or topical dimension of the content itself (e.g. 'hot streak', 'rivalry game', 'primetime matchup'). When omitted or empty, no content tag filtering is applied.

content_tag_type_ids
metadata_tag_type_ids
array of int64s

Filter flows by metadata tag type IDs. Metadata tags describe structural or entity-level attributes of the flow — properties inherited from the event, player, team, or league (e.g. 'NBA', 'quarterback', 'home team', 'playoff game'). When omitted or empty, no metadata tag filtering is applied.

metadata_tag_type_ids
boolean
Defaults to false

Controls the matching logic for content_tag_type_ids. When false (default), flows matching ANY of the requested content tags are returned (OR mode). When true, only flows matching ALL of the requested content tags are returned (AND mode).

boolean
Defaults to false

Controls the matching logic for metadata_tag_type_ids. When false (default), flows matching ANY of the requested metadata tags are returned (OR mode). When true, only flows matching ALL of the requested metadata tags are returned (AND mode).

int64
≥ 1
int64
1 to 25
Headers
string

Language code for localized trend narrative content. Active languages: en (English, default), es-419 (Spanish, Latin America), it (Italian), pt-BR (Portuguese, Brazil) — additional languages are added over time. Any BCP-47 tag is accepted, case-insensitive, with granular codes resolved to the closest available translation: an exact match wins, otherwise the base language ('es', 'es-ES', and 'es-MX' all resolve to es-419), and unmatched codes fall back to English. Only narrative text (fact condition descriptions, fun flow descriptions) is translated; reference data such as team, player, and league names is not. On /v1/trends/flows/quote this header carries the end user's locale to the configured check endpoint rather than translating anything itself — see that operation for details.

Response

Updated 3 months ago

Did this page help you?
Language
Credentials
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 3 months ago

Did this page help you?