markets.index [draft]

Resource information

URLhttps://api.statscore.com/v2/markets
MethodGET

Description

Returns a list of all available markets for prematch and live odds
Cache60 seconds
Authorization requiredYes

Method parameters

NameTypeDescription
There are no method parameters in this resource 

Query parameters

NameTypeDescription
tokenxsd:stringREQUIRED. There is more information concerning authorization in the API introduction section
pagexsd:intDetermines offset of paginated data. Default value is 1 which means first page
limitxsd:int

Determines maximum number of returned records on page. Used in paginated data. Default value is 500

Possible values: 5, 10, 25, 50, 100, 250, 500

market_type_idxsd:intDetermines the market type identifier. The complete list of possible markets types can be retrieved using the API resource: market-types.index
scope_idxsd:intDetermines the scope of the market. The complete list of possible scopes can be retrieved using the API resource: scopes.index
subtypexsd:string

Determines the subtype of the market. Possible values:

  • 2-way
  • 3-way
  • n-way
sport_idxsd:intDetermines the sport identifier for the market. The complete list of possible sports can be retrieved using the API resource: sports.index
is_default_marketxsd:int

Possible values:

  • yes - market is default for sport e.g: 1x2 market is default for soccer
  • no - market is not default
is_livexsd:string

Possible values:

  • yes - the market could be offer in live betting
  • no - the market couldn't be offer in live betting.
is_prematchxsd:string

Possible values:

  • yes - the market could be offer in prematch betting
  • no - the market couldn't be offer in prematch betting
statusxsd:int

Determines the status of the market. Possible values:

  • active - market currently using in our service
  • inactive - market which will be supported in the future 
timestampxsd:unix_timestampSelection date, format UNIX_TIMESTAMP. Only changes that occurred or were updated after this timestamp will be returned

Method calling examples

LinkDescription
https://api.statscore.com/v2/markets.xmlReturns a list of all markets in XML format
https://api.statscore.com/v2/marketsReturns a list of all markets in JSON format

Output elements

.markets
..market
idUnique identifier of the market
sport_idIdentifier for the sport. The complete list of possible sports can be retrieved using the API resource: sports.index
nameMarket name's pattern including replacers. It's used to generate final market name for specific event
static_nameStatic name of the market
market_type_idIdentifier type for the market e.g. Totals, Asian, Corners.The complete list of possible markets types can be retrieved using the API resource: markets-types.index
scope_idUnique identifier for the scope eg. First half, Regular Time. The complete list of possible scopes can be retrieved using the API resource: scopes.index
has_replacer

Possible values:

  • yes - the market and their default outcomes of the market contains replacer
  • no - the market and their default outcomes of the market not contains replacer
is_live

Possible values:

  • yes - the market could be offer in live betting
  • no - the market couldn't be offer in live betting
is_prematch

Possible values:

  • yes - the market could be offer in prematch betting
  • no - the market couldn't be offer in prematch betting
is_default_market

Possible values:

  • yes - market is default for sport e.g: 1x2 market is default for soccer
  • no - market is not default
subtype

Possible values:

  • 2-way:  the market includes 2 possible outcomes
  • 3-way: the market includes 3 possible outcomes
  • n-way: the market includes 1 or at least 4 possible outcomes
display_orderThe parameter used to sort markets
descriptionDescription of the market
status

Possible values:

  • active - market currently using in our service
  • inactive - market which will be supported in the future
utInformation about the date and time of when the record was last updated. Format UNIX_TIMESTAMP
...default_outcomes
....default_outcome
idIdentifier of the default outcome
nameOutcome name's pattern including replacers. It's used to generate final outcome name for specific event e.g: Under #totalPoints# will be replaced by Under 145.5
static_nameStatic name of the outcome
is_single_outcome

Possible values:

  • yes - single entity
  • no - generates a list of outcomes depending on specific object (used mostly for outright outcomes)
required_participant

Internal attribute. Possible values:

  • yes
  • no
display_orderThe parameter used to sort outcomes in the market
...replacers
....replacer
idIdentifier of the replacer
nameName of the replacer
format

Format of the replacer. Possible values:

descriptionDescription of the replacer

Samples XML/JSON

<markets>
	<market id="1" sport_id="5" name="3way" static_name="3way" market_type_id="1" scope_id="2" has_replacer="yes" is_live="yes" is_prematch="yes" subtype="3-way" is_default="yes" display_order="1" description="Match result in regular time" status="active" ut="12356712">
		<default_outcomes>
			<default_outcome id=1 name="#participant1#" static_name="Home" is_single_outcome="yes" required_participant="yes" display_order="1"/>
			<default_outcome id=3 name="Draw" static_name="Draw" is_single_outcome="yes" required_participant="no" display_order="2">
			<default_outcome id=2 name="#participant2#" static_name="Away" is_single_outcome="yes" required_participant="yes" display_order="3">
		</default_outcomes>
		<replacers>
			<replacer id="7" name="#participant1#" format="text" description="Name of the first participant connected to specific object" />
			<replacer id="8" name="#participant2#" format="text" description="Name of the second participant connected to specific object" />
 		</replacers>
 	</market>
</markets>

FAQ

For each example below you should use resource https://api.softnetsport.com/v2/markets?token={{YOUR_TOKEN}} and described query parameters


QuestionQuery parametersNote
1How do you retrieve a list of markets for soccer?
  • sport_id=5

2How do you retrieve a list of markets who could be offer for live events?
  • is_live=yes

3How do you retrieve a list of markets who could be offer for prematch events?
  • is_prematch=yes