Settlements

Modified on Wed, 17 Apr at 6: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

ElementData TypeDescription
FixtureIdint
The unique ID of the market
Market.IdintThe unique ID of the market
Market.Name
stringThe name of the market
Market.MainLinestring
The main line of the market (if there is one)
IdintThe uniqueness of the bet id is for a specific market under a specific fixture
NamestringThe name of the bet
LinestringThe line of the bet
BaseLinestringThe baseline helps you group all bets that belong together. In the example above – all bets with the same baseline (0:2) belong together
StatusenumThe status of the bet
StartPricedoubleThe initial price of the bet, when it was first introduced
PricedoubleThe price (odd) of the bet
SettlementenumRepresents how the bet was settled (resulted)
ProviderBetIdstringOPTIONAL: The bet ID, as shown by the provider
LastUpdateDateTimeTimestamp representing the time the bet was last updated
ParticipantIdintOPTIONAL: Reference ID to the participant in the fixture
Note: Provided in outright fixtures or in player's markets 
ProbabilitydoubleOPTIONAL: The Probability field is configurable per customer request. Probability won't be calculated and will be sent with value= "-1" in the following cases:
  1. one of the market bets is suspended. 
  2. one of the market bets is equal to or lower than 1.00 (similar to suspended).
  3. 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)
PlayerNamestringOPTIONAL: Appears only in player props markets, which are markets where the player's names are the bets.
SuspensionReasonintThe reason the bet was suspended
PriceUSstringOPTIONAL: The PriceUS field is configurable per customer request.
The price (odd) of the bet in American odds format
PriceHK
stringOPTIONAL: The PriceHK field is configurable per customer request.
The price (odd) of the bet in Hong Kong odds format


Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select at least one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article