markets.index [draft]

Resource information

URL	https://api.softnetsport.com/v2/markets
XSD
Method	GET
Description	Returns markets used in BetPartner product
Cache	60 seconds
Authorization required	Yes

Method parameters

Name	Type	Description
There are no method parameters in this resource

Query parameters

Name	Type	Description
token	xsd:string	REQUIRED. There is more information concerning authorization in the API introduction section
page	xsd:int	Determines offset of paginated data. Default value is 1 which means first page
limit	xsd: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_id	xsd:int	Determines the market type identifier. The complete list of possible markets types can be retrieved using the API resource: market-types.index
scope_id	xsd:int	Determines the scope of the market. The complete list of possible scopes can be retrieved using the API resource: scopes.index
subtype	xsd:string	Determines the subtype of the market. Possible values: 2-way 3-way n-way
sport_id	xsd:int	Determines the sport identifier for the market. The complete list of possible sports can be retrieved using the API resource: sports.index
is_default_market	xsd:int	Possible values: yes - market is default for sport e.g: 1x2 market is default for soccer no - market is not default
is_live	xsd:string	Possible values: yes - the market could be offer in live betting no - the market couldn't be offer in live betting
is_prematch	xsd:string	Possible values: yes - the market could be offer in prematch betting no - the market couldn't be offer in prematch betting
status	xsd: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
timestamp	xsd:unix_timestamp	Selection date, format UNIX_TIMESTAMP. Only changes that occurred or were updated after this timestamp will be returned

Method calling examples

Link	Description
https://api.softnetsport.com/v2/markets.xml	Returns a list of all markets in XML format
https://api.softnetsport.com/v2/markets	Returns a list of all markets in JSON format

Output elements

.markets
..market
id	Unique identifier of the market
sport_id	Identifier for the sport. The complete list of possible sports can be retrieved using the API resource: sports.index
name	Market name's pattern including replacers. It's used to generate final market name for specific event
static_name	Static name of the market
market_type_id	Identifier 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_id	Unique 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_order	The parameter used to sort markets
description	Description of the market
status	Possible values: active - market currently using in our service inactive - market which will be supported in the future
ut	Information about the date and time of when the record was last updated. Format UNIX_TIMESTAMP
...default_outcomes
....default_outcome
id	Identifier of the default outcome
name	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_name	Static 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_order	The parameter used to sort outcomes in the market
...replacers
....replacer
id	Identifier of the replacer
name	Name of the replacer
format	Format of the replacer. Possible values:
description	Description 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

	Question	Query parameters
1	How do you retrieve a list of markets for soccer?	sport_id=5
2	How do you retrieve a list of markets who could be offer for live events?	is_live=yes
3	How do you retrieve a list of markets who could be offer for prematch events?	is_prematch=yes