Get flows (paginated)

post

https://api.odditt.com/v1/trends/flows

Same parameters as mixed-flows but returns non-mixed (single-type) flows. Uses the same underlying request model.

Example response

{
  "fact_flow_records": [
    {
      "american_odds_value": "+280",
      "away_score": null,
      "away_team_display_name": "Minnesota Twins",
      "away_team_id": 9355,
      "betting_market_display_name": "1st Inning Team Runs Scored",
      "betting_market_id": 518,
      "betting_market_position_display_name": "Over",
      "betting_market_position_id": 4,
      "condition_emoji_payload": [
        "1F9F3",
        "1F303"
      ],
      "dark_mode_background_url": null,
      "decimal_odds_value": 3.8,
      "default_logo_url": "https://d1aarzeg4vkb0r.cloudfront.net/teams/9355.png",
      "default_split": "L20",
      "default_split_percentage": 60,
      "display_json": {
        "colors": [
          "red",
          "green",
          "red"
        ],
        "denominator": 20,
        "narrative": "Minnesota have scored more than 0.5 runs in the 1st inning in 12 of the last 20 away games played at night (local start time after 6pm)",
        "numerator": 12,
        "tagline": "60% in the last 20 night away games",
        "win_percentage": 60
      },
      "display_line_value": "0.5",
      "display_name_full": "Minnesota Twins",
      "event_betting_market_position_display_name": "Minnesota Over 0.5 - 1st Inning Team Runs Scored",
      "event_betting_market_position_id": 210346035,
      "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,
      "fact_flow_id": 570288621,
      "fact_flow_type": "base",
      "flow_type": "fact_flow",
      "fractional_odds_value": "280/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": "Seattle Mariners",
      "home_team_id": 9348,
      "league_id": 129,
      "light_mode_background_url": null,
      "line_value": 0.5,
      "odds_implied_probability": 0.263,
      "payout_multiplier": 2.8,
      "player_id": null,
      "sport_id": 4,
      "suggested_border_color_1": null,
      "suggested_border_color_2": null,
      "team_id": 9355,
      "tournament_type_id": null
    }
  ],
  "fact_parlay_records": [
    {
      "american_odds_value": "+357",
      "away_score": null,
      "dark_mode_background_url": "https://static.odditt.com/card-background-images/baseball-dark.png",
      "decimal_odds_value": 4.57,
      "event_betting_market_position_ids": [
        210409801,
        210423228
      ],
      "event_id": 3426307,
      "event_start_time_utc": "2026-08-01T02:10:00Z",
      "event_status": null,
      "fact_flow_ids": [
        570238899,
        570336011
      ],
      "fact_flow_parlay_id": 71846185,
      "flow_type": "fact_flow_parlay",
      "flows": [
        {
          "american_odds_value": "+110",
          "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,
          "condition_emoji_payload": [
            "1F9F3",
            "1F465"
          ],
          "decimal_odds_value": 2.1,
          "default_logo_url": "https://d1aarzeg4vkb0r.cloudfront.net/players/473196.png",
          "default_split": "L20",
          "default_split_percentage": 90,
          "display_json": {
            "colors": [
              "green",
              "green",
              "green"
            ],
            "denominator": 20,
            "narrative": "J. Bell has had more than 1.5 hits + runs + RBIs in 18 of the last 20 away games played against a former teammate (former teammate Josh Naylor plays for the opposing team)",
            "numerator": 18,
            "tagline": "90% in the last 20 away games vs a former teammate",
            "win_percentage": 90
          },
          "display_line_value": "1.5",
          "display_name_full": "Josh Bell",
          "event_betting_market_position_display_name": "J. Bell Over 1.5 - Hits + Runs + RBIs",
          "event_betting_market_position_id": 210409801,
          "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,
          "fact_flow_id": 570238899,
          "fact_flow_type": "base",
          "flow_type": "fact_flow",
          "fractional_odds_value": "110/100",
          "game_state": null,
          "graph_bars_have_labels": true,
          "graph_maximum_line_value": null,
          "graph_minimum_line_value": 1.5,
          "graph_type_name": "over_under",
          "home_score": null,
          "home_team_display_name": "Seattle Mariners",
          "home_team_id": 9348,
          "league_id": 129,
          "line_value": 1.5,
          "odds_implied_probability": 0.476,
          "payout_multiplier": 1.1,
          "player_id": 473196,
          "sport_id": 4,
          "team_id": 9355,
          "tournament_type_id": null
        },
        {
          "american_odds_value": "+140",
          "away_score": null,
          "away_team_display_name": "Minnesota Twins",
          "away_team_id": 9355,
          "betting_market_display_name": "Total Bases",
          "betting_market_id": 390,
          "betting_market_position_display_name": "Over",
          "betting_market_position_id": 4,
          "condition_emoji_payload": [],
          "decimal_odds_value": 2.4,
          "default_logo_url": "https://d1aarzeg4vkb0r.cloudfront.net/players/476185.png",
          "default_split": "H2H",
          "default_split_percentage": 58,
          "display_json": {
            "colors": [
              "green",
              "red",
              "green"
            ],
            "denominator": 31,
            "narrative": "R. Arozarena has had more than 1.5 total bases in 18 of the last 31 games vs. Minnesota",
            "numerator": 18,
            "tagline": "58% in the last 31 games against MIN",
            "win_percentage": 58
          },
          "display_line_value": "1.5",
          "display_name_full": "Randy Arozarena",
          "event_betting_market_position_display_name": "R. Arozarena Over 1.5 - Total Bases",
          "event_betting_market_position_id": 210423228,
          "event_id": 3426307,
          "event_name_short": "SEA vs. MIN",
          "event_start_time_utc": "2026-08-01T02:10:00+00:00",
          "event_status": null,
          "exact_score": null,
          "fact_flow_id": 570336011,
          "fact_flow_type": "base",
          "flow_type": "fact_flow",
          "fractional_odds_value": "140/100",
          "game_state": null,
          "graph_bars_have_labels": true,
          "graph_maximum_line_value": null,
          "graph_minimum_line_value": 1.5,
          "graph_type_name": "over_under",
          "home_score": null,
          "home_team_display_name": "Seattle Mariners",
          "home_team_id": 9348,
          "league_id": 129,
          "line_value": 1.5,
          "odds_implied_probability": 0.417,
          "payout_multiplier": 1.4,
          "player_id": 476185,
          "sport_id": 4,
          "team_id": 9348,
          "tournament_type_id": null
        }
      ],
      "fractional_odds_value": "357/100",
      "game_state": null,
      "home_score": null,
      "league_id": 129,
      "light_mode_background_url": "https://static.odditt.com/card-background-images/baseball-light.png",
      "odds_implied_probability": 0.219,
      "parlay_name": "⚾ Slugfest ⚾",
      "parlay_subtitle": "⚔️ Bell VS Arozarena: OPPOSING BATS GO OFF 🔥",
      "payout_multiplier": 3.57,
      "player_id": null,
      "sport_id": 4,
      "suggested_border_color_1": null,
      "suggested_border_color_2": null,
      "team_id": null,
      "tournament_type_id": null
    }
  ],
  "fun_flow_records": [
    {
      "american_odds_value": "-126",
      "away_score": null,
      "away_team_display_name": "Dallas Wings W",
      "away_team_id": 9253,
      "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.79,
      "default_logo_url": "https://d1aarzeg4vkb0r.cloudfront.net/players/514417.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": "Fudd is from the United States",
          "source_type": "player"
        },
        "3": {
          "emoji_json": [
            "1F4C5",
            "0032 FE0F 20E3",
            "0030 FE0F 20E3"
          ],
          "emoji_unicode": "1F4C5 0032 FE0F 20E3 0030 FE0F 20E3 0032 FE0F 20E3 0036 FE0F 20E3",
          "narrative": "Fudd was selected in the 2026 WNBA draft",
          "source_type": "player"
        }
      },
      "display_line_value": "13.5",
      "display_name_full": "Azzi Fudd",
      "event_betting_market_position_display_name": "A. Fudd Over 13.5 - Points Scored",
      "event_betting_market_position_id": 210121540,
      "event_id": 3426185,
      "event_name_short": "DAL @ WAS",
      "event_start_time_utc": "2026-07-31T23:30:00+00:00",
      "event_status": null,
      "exact_score": null,
      "flow_type": "fun_flow",
      "fractional_odds_value": "100/126",
      "fun_flow_id": 548107786,
      "game_state": null,
      "home_score": null,
      "home_team_display_name": "Washington Mystics W",
      "home_team_id": 9256,
      "league_id": 133,
      "light_mode_background_url": null,
      "line_value": 13.5,
      "odds_implied_probability": 0.558,
      "payout_multiplier": 0.794,
      "player_id": 514417,
      "sport_id": 2,
      "suggested_border_color_1": null,
      "suggested_border_color_2": null,
      "team_id": 9253,
      "tournament_type_id": null
    }
  ],
  "fun_parlay_records": [
    {
      "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
    }
  ],
  "page": 1,
  "page_size": 20,
  "plain_parlay_records": []
}

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

flow_type

string

enum

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

Allowed:

bet_type

string

enum

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

Allowed:

fact_flow_type

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

betting_market_entity_type

string

enum

Filter by betting market entity type

Allowed:

include_alt_lines

boolean

When false, exclude alt lines. Defaults to true.

include_only_basic_trends

boolean

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

include_deeplinks

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.

product_mode

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:

odds_format

string

enum

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

Allowed:

use_cartoon_images

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

sport_key

string

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

starting_soon

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.

full_hit_rate

boolean

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

split_type

string

enum

Filter by split type (overs or unders)

Allowed:

likelihood_type

string

enum

Filter by likelihood category

Allowed:

betting_market_category_ids

array of int64s

Filter by one or more betting market category IDs (e.g. Shooting Props, Game Props etc.). 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

focus_entity_type_id

int64

≥ 1

Filter by focus entity type ID

max_hit_rate_threshold

integer

0 to 100

Maximum hit rate threshold filter (0-100)

max_implied_probability_threshold

double

Maximum implied probability threshold filter

min_hit_rate_threshold

integer

0 to 100

Minimum hit rate threshold filter (0-100)

min_implied_probability_threshold

double

Minimum implied probability threshold filter

team_split

string

enum

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

Allowed:

event_start_date_from

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').

event_start_date_to

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').

include_star_sign_content

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

content_tag_require_all

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).

metadata_tag_require_all

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).

page

int64

≥ 1

page_size

int64

1 to 25

Headers

X-Language

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