Versions Compared

Old Version 4

changes.mady.by.user Former user

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 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

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 market type. Possible values:
  • prematch
    • live

    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
    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
     id name pattern scope sport_id param_value add_text 

    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_order
         
    The 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
     id name display_order 

    ....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

    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