Integration GuidesDocs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

Category Futures

Provides a list of futures available for a given category.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
⏱️

Update Frequency

TTL / Cache: 5 minutes

Data Updates: As futures prices move; bookmaker prices refresh every 3 minutes

Polling cadence for this and every other feed: Update Frequencies

📘

Tracking Futures Odds

Learn how to use the Category Futures feed to pull championship, division, and award markets, page through them, and refresh them in our Tracking Futures Odds integration scenario.

📘

Pagination Note

Pagination will often be required to pull all data within this feed. By default, the feed will return 5 futures.


Data Points

Market
AttributeParent ElementTypeDescription
end_datemarketStringEnd date of a market

ex. 2026-09-27
idmarketGUIDUnique ID of a market

ex. sr:iscreen_market:2564 (nba), sr:iscreen_market:8146 (wnba)
is_livemarketBooleanSignifies a market's sport event is live when true

This data point is typically irrelevant for Futures, and can be ignored
namemarketStringName of a market

ex. nba, wnba, nba - player - regular season - most valuable player
start_datemarketStringStart date of a market

ex. 2026-03-25
Books
AttributeParent ElementTypeDescription
external_market_idmarket - bookGUIDUnique market ID used by the bookmaker. Leverage this ID to create deeplinking

ex. 28049020
external_sport_event_idmarket - bookGUIDUnique sport event ID used by the bookmaker. Leverage this ID to create deeplinking

ex. 754.91649969
idmarket - bookGUIDUnique ID of a sportsbook for a market

ex. sr:book:18186
namemarket - bookStringName of a sportsbook for a market

ex. FanDuel
removedmarket - bookStringSignifies a book market has been removed when true
Market Outcome
AttributeParent ElementTypeDescription
competitor_idmarket - book - outcomeGUIDUnique competitor ID for a book outcome

ex. sr:competitor:3422
competitor_namemarket - book - outcomeStringCompetitor name for a book outcome

ex. Boston Celtics
external_outcome_idmarket - book - outcomeGUIDUnique outcome ID used by the bookmaker. Leverage this ID to create deeplinking

ex. 60427
field_idmarket - book - outcomeGUIDIdentifier for the outcome type

ex. 1 & 2 for home & away. 3, 4, & 5 for home, draw, & away
idmarket - book - outcomeGUIDUnique ID of an outcome

ex. sr:outcome:10001
odds_americanmarket - book - outcomeStringAmerican odds value of a book outcome

ex. +260
odds_decimalmarket - book - outcomeStringDecimal odds value of a book outcome

ex. 3.600
odds_fractionmarket - book - outcomeStringFractional odds value of a book outcome

ex. 13/5
open_odds_americanmarket - book - outcomeStringOpening American odds value of a book outcome

ex. +300
open_odds_decimalmarket - book - outcomeStringOpening decimal odds value of a book outcome

ex. 4.000
open_odds_fractionmarket - book - outcomeStringOpening fractional odds value of a book outcome

ex. 3/1
player_idmarket - book - outcomeStringUnique player ID for a book outcome.

ex. sr:player:1141196
player_namemarket - book - outcomeStringPlayer name for a book outcome.

ex. Tatum, Jayson
removedmarket - book - outcomeBooleanSignifies an outcome has been removed when true
typemarket - book - outcomeStringType of bet placements on a book outcome

ex. competitor or player
Path Params
string
enum
required
Defaults to trial

The access level of your API key

trial, production

Allowed:
string
required
Defaults to en

2-letter code for supported languages

en (English)

English is the only fully supported language for this API. Click here for valid language codes and a tabular list of available languages per competition.

string
required
Defaults to sr:category:15

Unique Id of a category, found in the Sport Categories endpoint

Example: sr:category:15 (USA, Basketball)

string
enum
required
Defaults to json

Format returned

json, xml

Allowed:
Query Params
string

Number to start the list of results from. Example: start=0

string

Number to limit the number of results. Minimum value is 1, maximum value is 5. Example: limit=5

boolean

Boolean value to return live/non-live markets

Example: live=true or live=false

Response

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