Settlements

Modified on Wed, 17 Apr 2024 at 06:34 PM

Settlement is a message that indicates a settlement of a specific bet/bets, what differs settlement messages from ordinary market messages are the Bet Status (3) and the "Settlement" property - Settlement Options.

XML

<Message>
  <Header CreationDate="2018-10-03T20:41:29.248Z">
    <Type>35</Type>
    <MsgGuid>572b65ab-1393-41ae-a4ff-f936f7bb3036</MsgGuid>
    <ServerTimestamp>1538599289420</ServerTimestamp>
  </Header>
  <MessageBody>
    <Events>
      <Event FixtureId="3882981">
        <Markets>
          <Market Id="2" Name="Under/Over">
            <Bets>
              <Bet Id="20803443503882981" Name="Over" Line="4.0" BaseLine="4.0" Status="3" StartPrice="1.0" Price="5.0" Settlement="1" ProviderBetId="8" LastUpdate="2018-10-03T20:41:29.138Z"/>
              <Bet Id="2907588603882981" Name="Under" Line="4.0" BaseLine="4.0" Status="3" StartPrice="1.0" Price="1.16" Settlement="2" ProviderBetId="8" LastUpdate="2018-10-03T20:41:29.138Z"/>
            </Bets>
          </Market>
        </Markets>
      </Event>
    </Events>
  </MessageBody>
</Message>

Json

{
   "Message": {
      "Header": {
         "Type": "35",
         "MsgGuid": "572b65ab-1393-41ae-a4ff-f936f7bb3036",
         "ServerTimestamp": "1538599289420",
         "CreationDate": "2018-10-03T20:41:29.248Z"
      },
      "MessageBody": {
         "Events": {
            "Event": {
               "Markets": {
                  "Market": {
                     "Bets": {
                        "Bet": [
                           {
                              "Id": "20803443503882981",
                              "Name": "Over",
                              "Line": "4.0",
                              "BaseLine": "4.0",
                              "Status": "3",
                              "StartPrice": "1.0",
                              "Price": "5.0",
                              "Settlement": "1",
                              "ProviderBetId": "8",
                              "LastUpdate": "2018-10-03T20:41:29.138Z",
                           },
                           {
                              "Id": "2907588603882981",
                              "Name": "Under",
                              "Line": "4.0",
                              "BaseLine": "4.0",
                              "Status": "3",
                              "StartPrice": "1.0",
                              "Price": "1.16",
                              "Settlement": "2",
                              "ProviderBetId": "8",
                              "LastUpdate": "2018-10-03T20:41:29.138Z",
                           }
                        ]
                     },
                     "Id": "2",
                     "Name": "Under/Over"
                  }
               },
               "FixtureId": "3882981"
            }
         }
      }
   }
}

Model

Element	Data Type	Description
FixtureId	int	The unique ID of the market
Market.Id	int	The unique ID of the market
Market.Name	string	The name of the market
Market.MainLine	string	The main line of the market (if there is one)
Id	int	The uniqueness of the bet id is for a specific market under a specific fixture
Name	string	The name of the bet
Line	string	The line of the bet
BaseLine	string	The baseline helps you group all bets that belong together. In the example above – all bets with the same baseline (0:2) belong together
Status	enum	The status of the bet
StartPrice	double	The initial price of the bet, when it was first introduced
Price	double	The price (odd) of the bet
Settlement	enum	Represents how the bet was settled (resulted)
ProviderBetId	string	OPTIONAL: The bet ID, as shown by the provider
LastUpdate	DateTime	Timestamp representing the time the bet was last updated
ParticipantId	int	OPTIONAL: Reference ID to the participant in the fixture `Note: Provided in outright fixtures or in player's markets`
Probability	double	OPTIONAL: The Probability field is configurable per customer request. Probability won't be calculated and will be sent with value= "-1" in the following cases: one of the market bets is suspended. one of the market bets is equal to or lower than 1.00 (similar to suspended). The market is a special market and TRADE360 cannot calculate fair odds or probability. If the probability ="-1", customers should not calculate the cash-out amount for the bets under this market (or line in case of a market with lines)
PlayerName	string	OPTIONAL: Appears only in player props markets, which are markets where the player's names are the bets.
SuspensionReason	int	The reason the bet was suspended
PriceUS	string	OPTIONAL: The PriceUS field is configurable per customer request. The price (odd) of the bet in American odds format
PriceHK	string	OPTIONAL: The PriceHK field is configurable per customer request. The price (odd) of the bet in Hong Kong odds format