API Reference

List Markets

get deprecated
https://api.sportsstack.io/api/v1/markets

Retrieve a list of betting markets with optional outcomes and odds data.

⚠️ Deprecation Notice

This endpoint is deprecated. Use /api/v1/market_odds for better performance and cleaner API design. The new endpoint automatically includes outcomes and odds data with optimized response structure.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string

[Translatable] Filter by Event ID

string

[Translatable] Filter by Tournament ID

string
required

Filter by League ID

boolean

Include outcomes and odds data in the response. When true, returns an optimized flattened structure that provides approximately 80% faster response times compared to the standard nested structure.

Performance Impact: Enabling this parameter triggers the optimized query path with:

  • Single database query instead of multiple queries
  • Efficient JOINs with performance indexes
  • Flattened response structure for faster JSON serialization
  • 250 row limit (max per_page) to prevent massive result sets
string

Filter by Market Group ID

string

Filter by Sportsbook ID

string

Filter by Aggregator ID

boolean

Only include mainline odds

string

The format for which field to query by (i.e. 'sportradar' will mean you can pass in the sportradar id) for any [Translatable] field

string

Include source mappings from the specific integration (i.e. 'sportradar') will return a source_mappings object with the mappings for the respective objects

integer
≥ 1
Defaults to 1

Page number

integer
1 to 1000
Defaults to 25

Number of items per page (max 1000)

Responses

Callback

Updated 3 months ago

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 3 months ago