Versions Compared

Old Version 13

changes.mady.by.user FormerUser1

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
/marketsXSDhttps://api.softnetsport.com/assets/API/docs/xsd
/markets
.index.xsd
MethodGET

Description

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

Method parameters

NameTypeDescription
There are
not
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. 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
is
sport_
live
idxsd:
string
intDetermines the
market type.
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
will
  • could be
used for
  • offer in live
odds
  • betting
  • no - the market couldn't be offer in live betting.
is_prematchxsd:string

Possible values:

  • yes - the market
will be used for pre-match oddssport_id
  • could be offer in prematch betting
  • no - the market couldn't be offer in prematch betting
statusxsd:int
REQUIRED.

Determines the

sport identifier for

status of the market.

softnetSPORT API provides the following sports: sports.index

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
which occured
that occurred or
was
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
f.e.: Fulltime - 1x2patternInternal attribute (f.e Jump distance #addText#)type
market_type_idIdentifier type
of
for the market
f.e: Under/over
e.g. Totals, Asian
. softnetSPORT API provides the following markets types
, Corners.The complete list of possible markets types can be retrieved using the API resource: markets-types.index
scope_idUnique identifier
of
for the scope
. softnetSPORT API provides the following scopes: scopes.indexsport_idUnique identifier of the sport. softnetSPORT API provides the following sports: sports.indexparam_value
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
includes param value
  • contains replacer
  • no -
-
  • the market and their default outcomes of the market
don't ncludes param valueadd_text
  • 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_
live
prematch

Possible values:

  • yes - the market
will
  • could be
use
  • offer in
live odds
  • prematch betting
  • no -
the
  •  the market
will
  • couldn't be
use in prematch odds
  • 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 f.e: 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