Outright Settlement

This documentation describes the complete structure of an Outright Settlement Update message (Type 42) as delivered by TRADE. What differs settlement messages from ordinary market messages are the Bet Status (3) and the "Settlement" property - Settlement Options.

JSON

{
  "Header": {
    "Type": 42,
    "MsgSeq": 1,
    "MsgGuid": "1010a7f8-c2fc-40ca-8928-8871e99b83d4",
    "CreationDate": "2025-07-20T23:27:48.9680601Z",
    "ServerTimestamp": 1753054068968
  },
  "Body": {
    "Competition": {
      "Id": 4221,
      "Name": "Emerald Downs",
      "Type": 0,
      "Competitions": [
        {
          "Id": 1,
          "Name": "All",
          "Type": 4,
          "Events": [
            {
              "FixtureId": 16247002,
              "Livescore": null,
              "Markets": [
                {
                  "Id": 160,
                  "Name": "Race Winner",
                  "Bets": [
                    {
                      "Id": "213192246116247002",
                      "Name": "Global Agenda",
                      "Status": 3,
                      "Price": "15",
                      "Settlement": 1,
                      "ProviderBetId": "0",
                      "LastUpdate": "2025-07-20T23:27:48.7569313Z",
                      "ParticipantId": 53894728,
                      "Probability": -1
                    },
                    {
                      "Id": "79468465916247002",
                      "Name": "Lead The Charge",
                      "Status": 3,
                      "Price": "3.75",
                      "Settlement": 1,
                      "ProviderBetId": "0",
                      "LastUpdate": "2025-07-20T23:27:48.7569313Z",
                      "ParticipantId": 51780807,
                      "Probability": -1
                    },
                    {
                      "Id": "214136128916247002",
                      "Name": "Cantcatchthiscat",
                      "Status": 3,
                      "Price": "2.17",
                      "Settlement": 1,
                      "ProviderBetId": "0",
                      "LastUpdate": "2025-07-20T23:27:48.7569313Z",
                      "ParticipantId": 53834472,
                      "Probability": -1
                    },
                    {
                      "Id": "226171316247002",
                      "Name": "Blackberry Jam",
                      "Status": 3,
                      "Price": "6",
                      "Settlement": 2,
                      "ProviderBetId": "0",
                      "LastUpdate": "2025-07-20T23:27:48.7569313Z",
                      "ParticipantId": 53873146,
                      "Probability": -1
                    },
                    {
                      "Id": "129824486016247002",
                      "Name": "Vino Viking",
                      "Status": 3,
                      "Price": "7.17",
                      "Settlement": 1,
                      "ProviderBetId": "0",
                      "LastUpdate": "2025-07-20T23:27:48.7569313Z",
                      "ParticipantId": 53894731,
                      "Probability": -1
                    },
                    {
                      "Id": "4301299916247002",
                      "Name": "Robin Racer",
                      "Status": 3,
                      "Price": "11",
                      "Settlement": 1,
                      "ProviderBetId": "0",
                      "LastUpdate": "2025-07-20T23:27:48.7569313Z",
                      "ParticipantId": 53894729,
                      "Probability": -1
                    }
                  ],
                  "ProviderMarkets": [
                    {
                      "Id": 8,
                      "Name": "Bet365",
                      "LastUpdate": "2025-07-20T23:27:48.7569313Z",
                      "Bets": [
                        {
                          "Id": "213192246116247002",
                          "Name": "Global Agenda",
                          "Status": 3,
                          "Price": "15",
                          "Settlement": 1,
                          "LastUpdate": "2025-07-20T23:27:48.7569313Z",
                          "ParticipantId": 53894728
                        },
                        {
                          "Id": "79468465916247002",
                          "Name": "Lead The Charge",
                          "Status": 3,
                          "Price": "3.75",
                          "Settlement": 1,
                          "LastUpdate": "2025-07-20T23:27:48.7569313Z",
                          "ParticipantId": 51780807
                        },
                        {
                          "Id": "214136128916247002",
                          "Name": "Cantcatchthiscat",
                          "Status": 3,
                          "Price": "2.17",
                          "Settlement": 1,
                          "LastUpdate": "2025-07-20T23:27:48.7569313Z",
                          "ParticipantId": 53834472
                        },
                        {
                          "Id": "226171316247002",
                          "Name": "Blackberry Jam",
                          "Status": 3,
                          "Price": "6",
                          "Settlement": 2,
                          "LastUpdate": "2025-07-20T23:27:48.7569313Z",
                          "ParticipantId": 53873146
                        },
                        {
                          "Id": "129824486016247002",
                          "Name": "Vino Viking",
                          "Status": 3,
                          "Price": "7.17",
                          "Settlement": 1,
                          "LastUpdate": "2025-07-20T23:27:48.7569313Z",
                          "ParticipantId": 53894731
                        },
                        {
                          "Id": "4301299916247002",
                          "Name": "Robin Racer",
                          "Status": 3,
                          "Price": "11",
                          "Settlement": 1,
                          "LastUpdate": "2025-07-20T23:27:48.7569313Z",
                          "ParticipantId": 53894729
                        }
                      ]
                    }
                  ]
                }
              ]
            }
          ]
        }
      ]
    }
  }
}

XML

Model

Competition

Element	Data Type	Description
Id	int	The unique ID of the competition
Name	name	The competition name
Type	enum	Type 3 is League, Type 4 is Season
Competitions	array	Array of Competitions

Event

Element	Data Type	Description
FixtureId	int	The unique ID of the fixture.
Livescore	int	Livescore
Markets	int	Markets

Markets

Element	Data Type	Description
Id	int	The unique ID of the market
Name	string	The name of the market
MainLine	string	OPTIONAL: Indicates the main line for relevant markets. Sends suspended if no open lines exist.
Bets	array	An array of Bets
ProviderMarkets	array	An array of ProviderMarket

Bets

Element	Data Type	Description
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	string	The initial price of the bet, when it was first introduced
Price	string	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 TRADE 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
PriceIN	string	OPTIONAL: The PriceHK field is configurable per customer request. The price (odd) of the bet in Indonesian odds format
PriceUS	string	OPTIONAL: The PriceUS field is configurable per customer request. The price (odd) of the bet in American odds format
PriceUK	string	OPTIONAL: The PriceHK field is configurable per customer request. The price (odd) of the bet in Fractional odds format
PriceMA	string	OPTIONAL: The PriceHK field is configurable per customer request. The price (odd) of the bet in Malaysian odds format
PriceHK	string	OPTIONAL: The PriceHK field is configurable per customer request. The price (odd) of the bet in Hong Kong odds format
Order	int	OPTIONAL: Defines the display and logical sequence of bets within the market.

ProviderMarkets

Available for Hybrid packages only

Element	Data Type	Description
Id	int	Unique identifier for the provider (e.g., 8 for Bet365).
Name	string	Name of the provider offering the odds (e.g., "Bet365").
LastUpdate	DateTime	Timestamp of the last update to the provider odds.
Bets	array	Contains an array of bet objects specific to the provider.

(Example - Horse racing "Result" will indicate the position that the participant arrived).