Versions Compared

Old Version 19

changes.mady.by.user Matthew Francis

Saved on

compared with

New Version Current

changes.mady.by.user Former user

Saved on

Key

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

Resource information

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

Description

Returns
bookmakers used in the softnetSPORT API
PackageThis resource is included in the PREMATCH ODDS and ODDS COMPARISON packages
a list of all available markets for prematch and live odds
Cache60 seconds
Authorization required
No
Yes

Method parameters

NameTypeDescription
There are no method parameters in this resource 

Query parameters

markets
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.
softnetSPORT API provides the following markets-types:
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.
softnetSPORT API provides the following scopes
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:int
REQUIRED.
Determines the sport identifier for the market.
softnetSPORT API provides the following sports
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.
softnetsport
statscore.com/v2/markets.xmlReturns a list of all markets in XML format
https://api.
softnetsport
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_name
Name
Static name of the market
e.g. Fulltime - 1x2patternInternal attribute (e.g. Jump distance #addText# → Jump distance Noriaki Kasai)type
market_type_idIdentifier type for the market e.g. Totals, Asian, Corners.
softnetSPORT API provides the following markets typessoftnetSPORT API provides the following scopes
The complete list of possible markets types can be retrieved using the API resource: markets-types.index
scope_idUnique identifier for the scope
. param_value
eg. First half, Regular Time. The complete list of possible scopes can be retrieved using the API resource: scopes.index
sport_idUnique identifier for the sport. softnetSPORT API provides the following sports: sports.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 outcome of
  • the market
contains param value
  • could be offer in live betting
  • no -
- the outcome of the market doesn't cointans param valueadd_text
  •  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
descriptionDescription of the market
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
name
Name of the outcome e,g, Home win, 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=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