Resource information
| URL | https://api.softnetsportstatscore.com/v2/markets | XSD | https://api.softnetsport.com/assets/API/docs/xsd/markets.index.xsd |
|---|---|---|---|
| Method | GET | ||
Description | Returns bookmakers used in API a list of all available markets for prematch and live odds | ||
| Cache | 60 seconds | ||
| Authorization required | NoYes |
Method parameters
| Name | Type | Description |
|---|---|---|
| There are no method parameters in this resource | ||
...
| Name | Type | Description |
|---|---|---|
| token | xsd:string | REQUIRED. More 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:
|
| sport_id | xsd:int | REQUIRED. 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:
|
| is_live | xsd:string | Possible values:
|
| is_prematch | xsd:string | Possible values:
|
| status | xsd:int | Determines the marketstatus of the market. Possible values:
|
| 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.softnetsportstatscore.com/v2/markets.xml | Returns a list of all markets in XML format |
| https://api.softnetsportstatscore.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 | NameStatic name of the market | e.g. Fulltime - 1x2||
| pattern | Internal attribute (e.g. Jump distance #addText# → Jump distance Noriaki Kasai) | ||
| type | |||
| 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 | ||
| sport_id | Unique identifier for the sport | ||
| param_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:
| ||
| is_live | Possible values:
| ||
| is_prematch | Possible values:
| ||
| is_default_market | Possible values:
| ||
| subtype | Possible values:
| ||
| display_order | The parameter used to sort markets | ||
| description | Description of the market | ||
| status | Possible values: | display_order | The parameter used to sort markets
|
| description | Description of the market | ||
| |||
| 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 | Name of the outcome e.g. Home, Under | pattern | Patter 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_name | Static name of the outcome | ||
| is_single_outcome | Possible values:
| ||
| required_participant | Internal attribute. Possible values:
| ||
| 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
| Code Block | ||
|---|---|---|
| ||
<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 | Note | |
|---|---|---|---|
| 1 | How do you retrieve a list of markets for soccer? |
| |
| 2 | How do you retrieve a list of markets who could be offer for live events? |
| |
| 3 | How do you retrieve a list of markets who could be offer for prematch events? |
|