A bet_cancel message is sent when a bet made on a particular market needs to be cancelled and refunded due to an error (which is different to a bet-settlement/refund). A bet_cancel can be sent for a market that has already been settled. This however only happens in rare circumstances when a market that should have been cancelled has been settled in error in a previous message. | Note |
|---|
Note A market status is only defined by odds_change messages. I.e. There is no reason to deactivate markets based on a bet_cancel message if there is no indication for doing so in an odds_change or bet_stop change message. |
Name | Description |
|---|
event_id | The ID of the event this cancel bet is for. | timestamp | When this event was generated (seconds since Epoch UTC). | product | The producer that generated this message (1=LiveOdds, 2=MTS, 3=BetradarCtrl, 4=Betpal, 5=premium cricket). | start_time
end_time | If start and end time are specified, they designate a range in time for which bets made should be cancelled. If there is an end_time but no start_time, this means cancel all bets placed before the specified time. If there is a start_time but no end_time this means, cancel all bets placed after the specified start_time. | superceded_by | Used in rare cases for outright odds, if the original tournament season id was wrong, the old odds_changes are bet_cancelled and the new tournament season id is included in the superceded_by attribute. A client seeing this bet_cancel has at least two choices: 1) just ignore the superceded_by attribute completely and just process the bet_cancel as any betcancel (i.e. void bets placed if any) 2) if possible move placed bets to the new tournament season id. | void_reason | Describes the reason for voiding certain outcomes for a particular market. Only set if at least one of the outcomes have a void_factor. A list of void reasons can be found HERE or by using the API at https://iodocs.betradar.com/ |
| Code Block |
|---|
| language | xml |
|---|
| theme | Eclipse |
|---|
| title | XML example |
|---|
| <bet_cancel end_time="1564598513000" event_id="sr:match:18941600" product="1" start_time="1564597838000" timestamp="1564602448841">
<market name="1st half - 1st goal" id="62" specifier="goalnr="1" void_reason="12"/>
</bet_cancel> |
|