Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Resource information

XSD
URLhttps://api.softnetsportstatscore.com/v2/marketshttps://api.softnetsport.com/assets/API/docs/xsd/markets.index.xsd
MethodGET

Description

Returns markets used in BetPartner producta list of all available markets for prematch and live odds
Cache60 seconds
Authorization requiredNoYes

Method parameters

NameTypeDescription
There are no method parameters in this resource 

...

NameTypeDescription
tokenxsd:stringREQUIRED. More 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 market 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.softnetsportstatscore.com/v2/markets.xmlReturns a list of all markets in XML format
https://api.softnetsportstatscore.com/v2/marketsReturns a list of all markets in JSON formatLista marketów dla sportuLista marketu dla scope, typuOstatnio zmienione markety

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
nameName of the outcome e.g. Home, Understatic namePatter of the outcome name e.g. Under #param#Outcome 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

Code Block
languagexml
<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=23 name="Draw" static_name="Draw" is_single_outcome="yes" required_participant="no" display_order="2">
			<default _outcome id=32 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></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