# Settlement This documentation describes the complete structure of a Settlement Update message (Type 35) as delivered by TRADE. What differs settlement messages from ordinary market messages are the [Bet Status](https://docs.lsports.eu/u/trade/enumerations/bet-settlements-and-statuses) (3) and the "Settlement" property - [Settlement Options](https://docs.lsports.eu/u/trade/enumerations/bet-settlements-and-statuses). {% tabs %} {% tab title="1x2 - JSON" %} ```json { "Header": { "Type": 35, "MsgSeq": 1, "MsgGuid": "691cbc2e-92d5-4f59-9dd4-548c8f67277b", "CreationDate": "2025-07-21T09:53:57.0874652Z", "ServerTimestamp": 1753091637087 }, "Body": { "Events": [ { "FixtureId": 24605698, "Livescore": null, "Markets": [ { "Id": 1, "Name": "1X2", "Bets": [ { "Probability": -1.0, "Id": 30713932524605698, "Name": "1", "Status": 3, "StartPrice": "1.0", "Price": "2.28", "Settlement": 1, "ProviderBetId": "0", "LastUpdate": "2025-07-21T09:53:56.180328Z", "PriceIN": "1.2799999999999998", "PriceUS": "128", "PriceUK": "9/7", "PriceMA": "-0.7812500000000001", "PriceHK": "1.2799999999999998", "Order": 1 }, { "Probability": -1.0, "Id": 92291723224605698, "Name": "X", "Status": 3, "StartPrice": "1.0", "Price": "3.8", "Settlement": 2, "ProviderBetId": "0", "LastUpdate": "2025-07-21T09:53:56.181244Z", "PriceIN": "2.8", "PriceUS": "280", "PriceUK": "14/5", "PriceMA": "-0.35714285714285715", "PriceHK": "2.8", "Order": 2 }, { "Probability": -1.0, "Id": 9614520224605698, "Name": "2", "Status": 3, "StartPrice": "1.0", "Price": "2.51", "Settlement": 1, "ProviderBetId": "0", "LastUpdate": "2025-07-21T09:53:56.180422Z", "PriceIN": "1.5099999999999998", "PriceUS": "151", "PriceUK": "3/2", "PriceMA": "-0.6622516556291391", "PriceHK": "1.5099999999999998", "Order": 3 } ], "ProviderMarkets": [ { "Id": 8, "Name": "Bet365", "LastUpdate": "2025-07-21T09:53:22.080305Z", "Bets": [ { "Id": 39686, "Name": "1", "Status": 3, "StartPrice": "1.0", "Price": "2.1", "Settlement": 1, "LastUpdate": "2025-07-21T09:53:56.180328Z", "Order": 1 }, { "Id": 39687, "Name": "X", "Status": 3, "StartPrice": "1.0", "Price": "4", "Settlement": 2, "LastUpdate": "2025-07-21T09:53:56.181244Z", "Order": 2 }, { "Id": 39688, "Name": "2", "Status": 3, "StartPrice": "1.0", "Price": "2.6", "Settlement": 1, "LastUpdate": "2025-07-21T09:53:56.180422Z", "Order": 3 } ] }, { "Id": 13, "Name": "BWin", "LastUpdate": "2025-07-21T09:53:22.081229Z", "Bets": [ { "Id": 33794, "Name": "1", "Status": 3, "StartPrice": "1.0", "Price": "2.25", "Settlement": 1, "LastUpdate": "2025-07-21T09:53:56.180328Z", "Order": 1 }, { "Id": 33795, "Name": "X", "Status": 3, "StartPrice": "1.0", "Price": "3.7", "Settlement": 2, "LastUpdate": "2025-07-21T09:53:56.181244Z", "Order": 2 }, { "Id": 33796, "Name": "2", "Status": 3, "StartPrice": "1.0", "Price": "2.52", "Settlement": 1, "LastUpdate": "2025-07-21T09:53:56.180422Z", "Order": 3 } ] }, { "Id": 74, "Name": "MarathonBet", "LastUpdate": "2025-07-21T09:53:22.081272Z", "Bets": [ { "Id": 33267, "Name": "1", "Status": 3, "StartPrice": "1.0", "Price": "2.3", "Settlement": 1, "LastUpdate": "2025-07-21T09:53:56.180328Z", "Order": 1 }, { "Id": 33268, "Name": "X", "Status": 3, "StartPrice": "1.0", "Price": "3.9", "Settlement": 2, "LastUpdate": "2025-07-21T09:53:56.181244Z", "Order": 2 }, { "Id": 33269, "Name": "2", "Status": 3, "StartPrice": "1.0", "Price": "2.5", "Settlement": 1, "LastUpdate": "2025-07-21T09:53:56.180422Z", "Order": 3 } ] } ] } ] } ] } } } ``` {% endtab %} {% tab title="U/O - JSON" %} ```json { "Header": { "Type": 35, "MsgSeq": 1, "MsgGuid": "a40488f0-6507-42a4-aaec-90ac70919c2b", "CreationDate": "2025-07-21T10:32:08.834871Z", "ServerTimestamp": 1753093928834 }, "Body": { "Events": [ { "FixtureId": 24605720, "Livescore": null, "Markets": [ { "Id": 2, "Name": "Under/Over", "Bets": [ { "Probability": -1.0, "Id": 101499058224605720, "Name": "Under", "Line": "0.5", "BaseLine": "0.5", "Status": 3, "StartPrice": "1.0", "Price": "1.45", "Settlement": 1, "ProviderBetId": "0", "LastUpdate": "2025-07-21T10:32:07.714635Z", "PriceIN": "-2.2222222222222223", "PriceUS": "-222", "PriceUK": "4/9", "PriceMA": "0.44999999999999996", "PriceHK": "0.44999999999999996" }, { "Probability": -1.0, "Id": 92513425824605720, "Name": "Over", "Line": "0.5", "BaseLine": "0.5", "Status": 3, "StartPrice": "1.0", "Price": "2.45", "Settlement": 2, "ProviderBetId": "0", "LastUpdate": "2025-07-21T10:32:07.715079Z", "PriceIN": "1.4500000000000002", "PriceUS": "145", "PriceUK": "13/9", "PriceMA": "-0.689655172413793", "PriceHK": "1.4500000000000002" } ], "ProviderMarkets": [ { "Id": 8, "Name": "Bet365", "LastUpdate": "2025-07-21T10:31:33.322206Z", "Bets": [ { "Id": 513, "Name": "Under", "Line": "0.5", "BaseLine": "0.5", "Status": 3, "StartPrice": "1.0", "Price": "1.6", "Settlement": 1, "LastUpdate": "2025-07-21T10:32:07.714635Z" }, { "Id": 514, "Name": "Over", "Line": "0.5", "BaseLine": "0.5", "Status": 3, "StartPrice": "1.0", "Price": "2.3", "Settlement": 2, "LastUpdate": "2025-07-21T10:32:07.715079Z" }, { "Id": 1026, "Name": "Under", "Line": "1.5", "BaseLine": "1.5", "Status": 2, "StartPrice": "1.0", "Price": "3.1", "LastUpdate": "2025-07-21T10:31:48.631029Z" }, { "Id": 1027, "Name": "Over", "Line": "1.5", "BaseLine": "1.5", "Status": 2, "StartPrice": "1.0", "Price": "1.3", "LastUpdate": "2025-07-21T10:31:48.631029Z" } ] }, { "Id": 13, "Name": "BWin", "LastUpdate": "2025-07-21T10:31:33.322824Z", "Bets": [ { "Id": 115, "Name": "Under", "Line": "0.5", "BaseLine": "0.5", "Status": 3, "StartPrice": "1.0", "Price": "1.4", "Settlement": 1, "LastUpdate": "2025-07-21T10:32:07.714635Z" }, { "Id": 116, "Name": "Over", "Line": "0.5", "BaseLine": "0.5", "Status": 3, "StartPrice": "1.0", "Price": "2.5", "Settlement": 2, "LastUpdate": "2025-07-21T10:32:07.715079Z" }, { "Id": 230, "Name": "Under", "Line": "1.5", "BaseLine": "1.5", "Status": 2, "StartPrice": "1.0", "Price": "3", "LastUpdate": "2025-07-21T10:31:48.631029Z" }, { "Id": 231, "Name": "Over", "Line": "1.5", "BaseLine": "1.5", "Status": 2, "StartPrice": "1.0", "Price": "1.4", "LastUpdate": "2025-07-21T10:31:48.631029Z" } ] }, { "Id": 74, "Name": "MarathonBet", "LastUpdate": "2025-07-21T10:31:33.322839Z", "Bets": [ { "Id": 439, "Name": "Under", "Line": "0.5", "BaseLine": "0.5", "Status": 3, "StartPrice": "1.0", "Price": "1.5", "Settlement": 1, "LastUpdate": "2025-07-21T10:32:07.714635Z" }, { "Id": 440, "Name": "Over", "Line": "0.5", "BaseLine": "0.5", "Status": 3, "StartPrice": "1.0", "Price": "2.4", "Settlement": 2, "LastUpdate": "2025-07-21T10:32:07.715079Z" }, { "Id": 878, "Name": "Under", "Line": "1.5", "BaseLine": "1.5", "Status": 2, "StartPrice": "1.0", "Price": "2.9", "LastUpdate": "2025-07-21T10:31:48.631029Z" }, { "Id": 879, "Name": "Over", "Line": "1.5", "BaseLine": "1.5", "Status": 2, "StartPrice": "1.0", "Price": "1.5", "LastUpdate": "2025-07-21T10:31:48.63103Z" } ] } ] } ] } ] } } } ``` {% endtab %} {% tab title="U/O - XML" %} {% code fullWidth="true" %} ```xml
35 572b65ab-1393-41ae-a4ff-f936f7bb3036 1538599289420
``` {% endcode %} {% endtab %} {% endtabs %} ## **Models** ### **Event** | **Element** | **Data Type** | **Description** | | ----------- | ------------- | ------------------------------------------------------------------------------------ | | FixtureId | int | The unique ID of the fixture. | | Livescore | int | [Livescore](https://docs.lsports.eu/u/trade/integration/message-structure/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 unique ID of the bet. Unique within 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](https://docs.lsports.eu/u/trade/enumerations/bet-settlements-and-statuses) 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](https://docs.lsports.eu/u/trade/enumerations/bet-settlements-and-statuses) (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:

  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 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](https://docs.lsports.eu/u/trade/enumerations/bet-suspension-reasons) the bet was suspended | | PriceIN | string | **OPTIONAL**: The PriceIN 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 PriceUK field is configurable per customer request. The price (odd) of the bet in Fractional odds format | | PriceMA | string | **OPTIONAL**: The PriceMA 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**: Sequential integer (starting from 1) defining the intended display order of bets within a market. Defaults to `null` if ordering data is unavailable. | #### ProviderMarkets {% hint style="info" %} **Note:** Available for ProviderOdds+ packages only. Contact your CSM to enable ProviderOdds+ access. {% endhint %} | **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. |