Filtering & Query Parameters

Most Odditt B2B API endpoints accept filtering parameters to narrow down results. This guide covers the common parameters available across the API.

Pagination

Applies to: all list endpoints (/v1/references/*, /v1/trends/*, /v1/games/*, /v1/betting/*, /v1/account/*)

All list endpoints support pagination:

Parameter	Type	Default	Max	Description
`page`	integer	1	-	Page number (minimum: 1)
`page_size`	integer	20	100	Results per page

See Pagination for details on the response format.

Applies to: /v1/trends/*, /v1/games/*, /v1/betting/*

Filter by sport, league, team, or player. You can use either numeric IDs or external keys:

When both an ID and a key are provided for the same entity, the ID takes precedence.

Applies to: /v1/trends/mixed-flows, /v1/trends/flows

Control which types of flows are returned:

Parameter	Values	Description
`flow_type`	`fact`, `fun`, `plain`	Type of flow. `plain` only returns parlays
`bet_type`	`singles`, `parlay`, `same_game_parlay`	Filter by bet structure
`fact_flow_type`	`base`, `expanded`	Sub-type for fact flows (default: `base`)

{
  "sport_id": 1,
  "league_id": 7,
  "flow_type": "fact",
  "bet_type": "singles",
  "page": 1,
  "page_size": 10
}

Applies to: /v1/trends/mixed-flows, /v1/trends/flows

Filter flows by statistical thresholds:

Parameter	Type	Range	Description
`min_hit_rate_threshold`	integer	0–100	Minimum hit rate (percentage)
`max_hit_rate_threshold`	integer	0–100	Maximum hit rate (percentage)
`min_implied_probability_threshold`	number	0.0–1.0	Minimum implied probability
`max_implied_probability_threshold`	number	0.0–1.0	Maximum implied probability
`full_hit_rate`	boolean	-	Include full hit rate data in response

{
  "sport_id": 1,
  "min_hit_rate_threshold": 55,
  "max_hit_rate_threshold": 85,
  "page": 1,
  "page_size": 10
}

Applies to: /v1/trends/mixed-flows, /v1/trends/flows

Parameter	Values	Description
`split_type`	`overs`, `unders`	Filter by over/under
`likelihood_type`	`likely`, `possible`, `longshot`	Filter by likelihood category

Applies to: /v1/trends/*, /v1/betting/*

Filter by sportsbook operators using IDs or external keys:

Parameter	Type	Description
`operator_ids`	array of integers	Include only these operators
`operator_keys`	array of strings	Include only these operators (e.g. `["draftkings", "fanduel"]`)
`excluded_operator_ids`	array of integers	Exclude these operators
`excluded_operator_keys`	array of strings	Exclude these operators

When both operator_ids and operator_keys are provided, the resolved IDs are merged together.

Applies to: /v1/trends/*, /v1/betting/*

Parameter	Type	Description
`betting_market_ids`	array of integers	Filter by betting market IDs
`betting_market_category_id`	integer	Filter by betting market category
`betting_market_entity_type`	string	`"player"`, `"team"`, or `"event"`

Applies to: /v1/trends/*, /v1/games/*

Parameter	Type	Description
`event_start_date_from`	string (ISO date)	Events starting on or after this date
`event_start_date_to`	string (ISO date)	Events starting on or before this date

{
  "sport_id": 1,
  "event_start_date_from": "2026-03-26",
  "event_start_date_to": "2026-03-28",
  "page": 1,
  "page_size": 10
}

Applies to: /v1/trends/* (some also /v1/betting/*)

Parameter	Default	Description
`include_deeplinks`	`false`	Return operator-specific deeplink URLs. Requires exactly one operator ID.
`include_alt_lines`	`true`	Include alternative lines
`include_only_womens_sports`	`false`	Only return women's sports flows
`include_only_basic_trends`	`false`	Omit fact flows with conditions
`starting_soon`	`false`	Only return flows for events starting soon
`full_hit_rate`	`false`	Include full hit rate breakdown

Applies to: /v1/references/*

Reference endpoints support text search:

Parameter	Type	Description
`search`	string	Search by name (partial match)

curl "https://api.odditt.com/v1/references/teams?search=patriots&page=1&page_size=10" \
  -H "X-API-Key: YOUR_API_KEY"

Applies to: /v1/betting/*

Parameter	Default	Description
`country_code`	`"US"`	ISO 3166-1 alpha-2 country code
`country_iso_code`	-	ISO country code (affiliate offers)
`subnational_region_code`	-	ISO 3166-2 state/province code