# Bet Stop

The *bet\_stop* message is an optimized signal to indicate that all, or a set of markets should be instantly suspended (continue to display odds, but don't accept tickets). The same effect can also be achieved by sending an odds\_change message that lists all the affected markets and moves them to status="-1" (suspended)

It is important to keep in mind that only ***active*** markets should be set to *suspended*, and not markets that are already ***deactivated***, ***settled*** or ***canceled***. 

This is also the case for the attribute *market\_status*. If it is not present, the market should be moved to suspended. However, if the market is already *deactivated*, *settled* or *cancelled* this is not a good practice. Only move **ACTIVE** markets to suspended.

The *bet\_stop* is sent very rapidly, as soon as a Betradar operator detects an issue. At the time the bet\_stop is sent, the cause for the betstop is not always available (typically not for live matches). The cause of the bet\_stop is provided in a subsequent [*odds\_change*](https://docs.sportradar.com/uof/data-and-features/messages/event/odds-change) message.

{% hint style="success" %}
The betstop is sent very rapidly, as soon as a Betradar operator detects an issue. At the time the betstop is sent the cause for the betstop is not always available (typically not for live matches). The cause of the bet\_stop is provided in a subsequent odds\_change message.
{% endhint %}

| **Attribute**   | **Description**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| timestamp       | The timestamp (milliseconds since epoch UTC) for this message.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| `product`       | The Betradar producer that is sending this message (1=LiveOdds, 2=MTS, 3=BetradarCtrl, 4=BetPal, 5=Premium Cricket). See the endpoint descriptions/producers.xml for a listing of current producers.                                                                                                                                                                                                                                                                                                                                                                                      |
| event\_id       | What sport event this message refers to.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| groups          | A description of which set of markets should be suspended – the value should be a group-name as can be seen in the market-descriptions (‘all’ is a special keyword that means all markets for this event).                                                                                                                                                                                                                                                                                                                                                                                |
| market\_status  | If not present, the markets specified should be moved to suspended. If present, they should be either suspended or deactivated based on the value of this field.                                                                                                                                                                                                                                                                                                                                                                                                                          |
| betstop\_reason | <p>If present, describes the reason for the bet stop.</p><p>The betstop\_reason should <strong>NOT</strong> be used to trigger a bet\_stop on the customer side. </p><p></p><p>This is an additional attribute with information that is set by our scouts in order to inform customers why a certain bet\_stop was set. This attribute is <strong>OPTIONAL</strong> and there are scenarios where no betstop\_reason will be sent.</p><p></p><p><mark style="color:red;"><strong>NOTE</strong>:</mark> Not all producers use this attribute either (i.e: The <em>Ctrl</em> producer).</p> |

**XML Example**

```xml
<bet_stop timestamp="12345" product="3" event_id="sr:match:471123" groups="all"/>
```

The above XML example indicates the bet\_stop. The attribute "groups" defines which markets should go to bet\_stop (or be closed/deactivated). Currently it is by default set to "all". If a bet\_stop message is received, all markets should go to betstop/should be closed.

After the betstop message is received you will find the markets which should be on betstop with the market status attribute set to "-1" in a subsequent odds\_change message. As long as a certain market does not change to status="1", it should be on betstop/closed on the customer side.

If a certain market goes to status="1" it would be open (betstart) for betting again.

{% hint style="info" %}
**Bet stop hierarchy**

Please note that bets are stopped in a hierarchy. To see if bets are open on an outcome for a market and an event, the rules below all need to passed:

1. The Betradar system is available (messages have been received in the last 20 seconds).
2. The product handling the event is not flagged as down.
3. The market status is active (not suspended or deactivated).
4. The outcome is active (not active="false").

Conversely, if any of the above conditions become false, all corresponding bets should be stopped.
{% endhint %}

{% hint style="success" %}
Currently there is a difference in how the Premium Cricket producer and Ctrl producer send bet\_stop messages (pre-match only). In Ctrl you will receive a *bet\_stop* at match kick off, but in Premium Cricket you will receive a normal *odds\_change* message with the attribute status=”0”.
{% endhint %}