betting-offers.show [draft]

Resource information

URL	https://api.softnetsport.com/v2/betting-offers
XSD
Method	GET
Description	Returns detailed information for a requested betting offer
Cache	No
Authorization required	Yes

Method parameters

Name	Type	Description
betting_offer_id	xsd:int	REQUIRED. The requested competition identifier

Query parameters

Name	Type	Description
token	xsd:string	REQUIRED. There is more information concerning authorization in the API introduction section
lang	xsd:string	Determines the language for the output data. The complete list of possible languages can be retrieved using the API resource: languages.index
tz	xsd:string	Determines timezone for the output data. The complete list of possible time zones is included 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 betting markets on page. Used in paginated data. Default value is 50. Possible values: 5, 10, 25, 50, 100
market_id	xsd:int	Determines the market identificator. Possibility to input multiple identifiers, separated by comma. The complete list of possible markets can be retrieved using the API resource: markets.index
scope_id	xsd:int	Determines the scope identificator. Possibility to input multiple identifiers, separated by comma. The complete list of possible scopes can be retrieved using the API resource: scopes.index
market_type_id	xsd:int	Determines the market type identificator. Possibility to input multiple identifiers, separated by comma. The complete list of possible markets types can be retrieved using the API resource: markets-types.index
default_market	xsd:int	Possible values: yes - display only one most important market for each sport. For soccer it will be 1x2 market, for tennis: 12 market. The complete list of possible markets and their default market can be retrieved using the API resource: markets.index no - display all markets for sport excluding the one market marked as a default (default value)
sort_type	xsd:string	Determines sort order of data. Possible values: competition - betting markets are sorted by the name of the competition start_date - betting markets are sorted by the start_date (default value)
sort_order	xsd:string	Additional parameter for sort_type which determines the direction of sorting (ascending, descending) Possible values: asc - sort ascending desc - sort descending (default value)
market_ids	xsd:string	List of market identifiers separated by a comma (e.g. 123,234,321). Possibility to input multiple identifiers, separated by comma. The complete list of possible markets can be retrieved using the API resource: markets.index
betting_offer_status	xsd:string	Determines status of betting offer. Possible values: active - the odds are published and users can make bets. Defaut value for new betting market suspended - the users can't bet on the market (e.g when team received the red card) closed - the market is closed and no further bets will be taken removed - the market is removed and no further bets will be taken resulted - final status of the market, all outcomes for betting market have results
resulted_outcomes	xsd:string	Determines values of outcomes result: yes - outcomes with result attribute no - outcomes without result attribute
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/betting-offers/9812.xml?token={{YOUR_TOKEN}}	Returns a list of all betting offers for the customer in XML format
https://api.softnetsport.com/v2/betting-offers /9812 ?token={{YOUR_TOKEN}}	Returns a list of all betting offers for the customer in JSON format
https://api.softnetsport.com/v2/betting-offers/9812 .xml?token={{YOUR_TOKEN}}&is_live_market=yes	Returns a list of all live betting offers for the customer in XML format
https://api.softnetsport.com/v2/betting-offers/9812 .xml?token={{YOUR_TOKEN}}&is_live_market=no	Returns a list of all prematch betting offers for the customer in XML format

Output elements

.betting_markets
..betting_market
id	Identifier of the betting market
bookmaker_id	Identifier of the bookmaker assigned to you during subscription purchase
is_live_market	Possible values: yes - in-play betting markets no - prematch betting markets * * If live odds are going to be available for the event one minute before the event start date we will change this attribute from „no” to „yes”. If we don't offer live odds for the event all betting markets will be closed at this moment.
market_id	Identifier for the market. The complete list of possible markets and their default market can be retrieved using the API resource: markets.index
market_name	Name of the market
object_type	Possible object type: season event
object_name	Name of the object e.g: Barcelona - Real Madrid or Premiership 2015/16
sport_id	Unique identifier for the sport. The complete list of possible sports can be retrieved using the API resource: sports.index
area_id	Unique identifier for the area. The complete list of possible areas can be retrieved using the API resource: areas.index
competition_id	Unique identifier for the competition. The complete list of possible competitions can be retrieved using the API resource: competitions.index
season_id	Unique identifier for the season. The complete list of possible seasons can be retrieved using the API resource: seasons.index
event_id	Unique identifier for the event. The complete list of possible events can be retrieved using the API resource: events.index
event_status_id	Unique identifier of the event status. Available only when object_type=event, in other cases null value The complete list of possible events statuses can be retrieved using the API resource: statuses.index
event_result	Result for the event in format result1:result2 e.g: 2:0. For some sports like tennis attribute will contain results of each period seperated by \| e.g 1:1\| 4:5 \|15:0 Available only when object_type=event and for an event with 2 participants, in other cases null value
clock_status	Clock status. Possible value: running stopped Available only when object_type=event, in other cases null value
clock_time	How many seconds have passed in the current event period. Available only when object_type=event, in other cases null value
replacer	For some markets we are using replacers. It's a list of key=value atributtes seperated by \| e.g. participant1=Barcelona \| participant2=Real. The complete list of possible replacers for each market can be retrieved using the API resource: markets.index. Possible null value.
status	Possible values: active - the odds are published and users can make bets. Defaut value for new betting market suspended - the users can't bet on the market (e.g when team received the red card) closed - the market is closed and no further bets will be taken resulted - all outcomes for betting market have results removed - the market is removed and no further bets will be taken
display_order	The parameter used to sort betting markets. Sorting direction is ascending
start_date	Date when the betting offer starts in format DATE_TIME (2015-03-01 11:02)
open_at	Date when the betting offer was opened in format DATE_TIME (2015-03-01 11:02)
closed_at	Date when the betting offer should be closed in format DATE_TIME (2015-03-01 11:02)
ut	Information about the date and time of when the record was last updated. Format UNIX_TIMESTAMP
...outcomes
....outcome
id	Identifier of the outcome
default_outcome_id	Default outcome id. The complete list of possible default outcomes can be retrieved using the API resource: default-outcomes.index
name	Name of the outcome
participant_id	Identifier of the participant related to the outcome. Possible null value. The complete list of possible participants can be retrieved using the API resource: participants.index
status	Possible values: active - outcome and odds are displayed, user can make bets. Default value for new outcome suspended - outcome is suspended, user can't make bets closed - outcome is closed and will be not offer it the future, user can't make bets resulted - outcome has result (result attribute is not empty) removed - outcome is removed, user can't make bets
result	Possible values: won - user won his bet, user should receive winnings (oddsstake) lost - user lost his bet, user lost his stake void - user should receive his stake back partial win - user won part of his bet, user should receive winnings (oddsstake/2 + stake/2) partial loss - user lost part of his bet, user should receive half of his stake back Possible empty value for betting markets yet to be settled.
starting_odds	The starting odds offered by the bookmaker in decimal format
odds	The current odds offered by the bookmaker in decimal format
probability	Probability of the outcome in format 0.65
display_order	The parameter used to sort outcomes. Sorting direction is ascending
ut	Information about the date and time of when the record was last updated. Format UNIX_TIMESTAMP

Sample XML/JSON

<betting_offers>
	<betting_offer id="190909093" bookmaker_id="1" is_live_market="yes" market_id="1" market_name="3way" object_type="event" object_name="Legia Warsaw - Borussia" sport_id="5" area_id="144" competition_id="12" season_id="13456" event_id="22345" event_status_id="1" event_result="0:0" clock_status="running" clock_time="9012" replacer="participant1=Legia Warsaw|participant2=Borussia" status="active" display_order="1" start_date="2016-09-14 20:45:00" open_at="2016-09-12 05:12" closed_at="2016-09-14 20:45:00" ut="12345622323">
 		<outcomes>
			<outcome id="112312" default_outcome_id="1" name="Legia Warsaw" participant_id="136763" status="active" result="none" starting_odds="10.50" odds="9.75" probability="0.0977" display_order="1" ut="12345622323"/>
			<outcome id="112313" default_outcome_id="3" name="Draw" participant_id="" status="active" result="none" starting_odds="5.00" odds="4.85"  probability="0.1965" display_order="2" ut="12345622323"/>
			<outcome id="112314" default_outcome_id="2" name="Borussia" participant_id="136359" status="active" result="none" starting_odds="1.34" odds="1.35" probability="0.7058" display_order="3" ut="12345622323"/>
 		</outcomes>	
	</betting_offer>
</betting_offers>

FAQ

For each example below you should use resource https://api.softnetsport.com/v2/betting-offers/987?token={{YOUR_TOKEN}} and described query parameters

	Question	Query paremeters
1	How do you retrieve a list of betting markets updated from selected date?	ut=1289009099
2	How do you retrieve a list of betting markets having all resulted outcomes?	betting_market_status=resulted
3	How do you retrieve a list of betting markets having resulted a part of outcomes?	resulted_outcomes=yes
4	Scope
5	Typy marketów