Outright League Fixture

This documentation describes the complete structure of an Outright League Fixture Update message (Type 38) as delivered by TRADE.

JSON

[
  {
    "Header": {
      "Type": 38,
      "MsgSeq": 1,
      "MsgGuid": "f2e6f2b1-c737-4847-bd8f-c8505daf104f",
      "CreationDate": "2024-06-25T08:18:00.8515215Z",
      "ServerTimestamp": 1719303480851
    },
    "Body": {
      "Competition": {
        "Id": 67,
        "Name": "Premier League",
        "Type": 3,
        "Competitions": [
          {
            "Id": 2029,
            "Name": "2023/2024",
            "Type": 4,
            "Events": [
              {
                "FixtureId": 22751084,
                "OutrightLeague": {
                  "Subscription": {
                    "Type": 2,
                    "Status": 1
                  },
                  "Sport": {
                    "Id": 6046,
                    "Name": "Football"
                  },
                  "Location": {
                    "Id": 248,
                    "Name": "International"
                  },
                  "LastUpdate": "2024-06-25T08:17:39.179941Z",
                  "Status": 1,
                  "ExtraData": [
                    {
                      "Name": "WithLivescore",
                      "Value": "false"
                    },
                    {
                      "Name": "WithInPlay",
                      "Value": "false"
                    }
                  ],
                  "EndDate": "2026-05-02T00:00:00"
                },
                "Livescore": null,
                "Markets": null
              }
            ]
          }
        ]
      }
    }
  }
]

Predictions - JSON

[
  {
    "Header": {
      "Type": 38,
      "MsgSeq": 1,
      "MsgGuid": "3fa4b18a-6d2b-4a71-9c3e-8b6a2f6e1c4d",
      "CreationDate": "2025-08-01T12:00:00.0000000Z",
      "ServerTimestamp": 1754049600000
    },
    "Body": {
      "Competition": {
        "Id": 9001,
        "Name": "Politics",
        "Type": 3,
        "Competitions": [
          {
            "Id": 9002,
            "Name": "US 2025",
            "Type": 4,
            "Events": [
              {
                "FixtureId": 25000002,
                "OutrightLeague": {
                  "Subscription": {
                    "Type": 2,
                    "Status": 1
                  },
                  "Sport": {
                    "Id": 9000,
                    "Name": "Predictions"
                  },
                  "Location": {
                    "Id": 248,
                    "Name": "International"
                  },
                  "LastUpdate": "2025-08-01T11:58:42.1179410Z",
                  "Status": 1,
                  "FixtureName": "Who will be the next Fed Chair?",
                  "Participants": [
                    {
                      "Id": 71000001,
                      "Name": "Kevin Warsh",
                      "Position": "1",
                      "IsActive": true,
                      "Type": 3,
                      "ExtraData": [
                        {
                          "Name": "Rules",
                          "Value": "{\"title\":\"Will Kevin Warsh be confirmed as Fed Chair before Jan 1, 2029?\",\"name\":\"Kevin Warsh\",\"can_close_early\":true,\"fractional_trading_enabled\":true,\"close_unconfirmed\":true,\"rulebook_variables\":{\"contract_ticker\":\"NOMINEECONF\",\"date\":\"Jan 1, 2029\",\"early_close_condition\":\"This market will close early if the event occurs\",\"expected_determination_time\":\"2029-01-01T15:00:00.000Z\",\"nominee\":\"Kevin Warsh\",\"position\":\"Chair of the Board of Governors of the Federal Reserve System\",\"settlement_timer_hours\":\"0.5\"}}"
                        }
                      ]
                    },
                    {
                      "Id": 71000002,
                      "Name": "Jerome Powell",
                      "Position": "2",
                      "IsActive": true,
                      "Type": 3,
                      "ExtraData": [
                        {
                          "Name": "Rules",
                          "Value": "{\"title\":\"Will Jerome Powell be confirmed as Fed Chair before Jan 1, 2029?\",\"name\":\"Jerome Powell\",\"can_close_early\":true,\"fractional_trading_enabled\":true,\"close_unconfirmed\":true,\"rulebook_variables\":{\"contract_ticker\":\"NOMINEECONF\",\"date\":\"Jan 1, 2029\",\"early_close_condition\":\"This market will close early if the event occurs\",\"expected_determination_time\":\"2029-01-01T15:00:00.000Z\",\"nominee\":\"Jerome Powell\",\"position\":\"Chair of the Board of Governors of the Federal Reserve System\",\"settlement_timer_hours\":\"0.5\"}}"
                        }
                      ]
                    }
                  ],
                  "ExtraData": [
                    {
                      "Name": "Rules",
                      "Value": "{\"title\":\"Who will be the next Fed Chair?\",\"can_close_early\":true,\"fractional_trading_enabled\":true,\"close_unconfirmed\":true,\"rulebook_variables\":{\"contract_ticker\":\"NOMINEECONF\",\"date\":\"Jan 1, 2029\",\"early_close_condition\":\"This market will close early if the event occurs\",\"expected_determination_time\":\"2029-01-01T15:00:00.000Z\",\"position\":\"Chair of the Board of Governors of the Federal Reserve System\",\"settlement_timer_hours\":\"0.5\"}}"
                    }
                  ],
                  "EndDate": "2029-01-01T00:00:00"
                },
                "Livescore": null,
                "Markets": null
              }
            ]
          }
        ]
      }
    }
  }
]

Model

Competition

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

Competitions

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

Events

Element	Data Type	Description
FixtureId	int	The unique ID of the fixture.
OutrightLeague	object	OutrightLeague
Livescore	object	Livescore
Markets	array	An array of Markets

OutrightLeague

Element	Data Type	Description
Subscription	object	Subscription
Sport	object	Sport
Location	object	Location
Season	object	Season
StartDate	string	The fixture start date
LastUpdate	string	ISO timestamp of the last update to the provider odds
Status	enum	The current status of the fixture
Participants	array	An array of Participants
FixtureExtraData	array	An array of FixtureExtraData
ExternalFixtureId	string	Use to map fixtures to an external provider; to enable this feature, please contact your CSM.
Venue	object	Venue
Season	object	Season
FixtureName	string	fixture name (e.g. Team A vs Team B).

Subscription

Element	Data Type	Description
Type	enum	Your package type
Status	enum	The current subscription status of the event in your package

Sport

Element	Data Type	Description
Id	int	The unique ID of the sport
Name	string	The name of the sport

Location

Element	Data Type	Description
Id	int	The unique ID of the location
Name	string	The name of the location

Season

Element	Data Type	Description
ID	int	Unique identifier representing the season.
Name	string	The name of the season.

Participant

Element	Data Type	Description
Id	int	The unique ID of the participant
Name	string	The name of the participant
Position	string	In standard fixtures: 1 = home, 2 = away. In outright events: sequential draw or programme number assigned to each participant.
RotationId	int	OPTIONAL: Rotation identifier for the participant
IsActive	bool	Will only show in outright events.
Gender	int	OPTIONAL: Gender of the participant. 1 = Men, 2 = Women, 3 = Mix
AgeCategory	int	OPTIONAL: Age category of the participant. 0 = Regular, 1 = Youth, 2 = Reserves
Type	int	OPTIONAL: Participant type. 1 = Club, 2 = National, 3 = Individual, 4 = Virtual, 5 = Esports, 6 = VirtuReal (deprecated — no longer issued), 7 = Doubles
Form	string	OPTIONAL: Recent form of the participant (e.g. WWDLW).
Formation	string	OPTIONAL: Tactical formation used by the participant (e.g. 4-3-3).
FixturePlayers	array	OPTIONAL: Lineup / roster information for the participant. See FixturePlayers.
ShirtColor	string	OPTIONAL: Primary shirt color of the participant.
GoalKeeperShirtColor	string	OPTIONAL: Goalkeeper shirt color of the participant.
ExtraData	array	Array of data ExtraData

FixturePlayers

Element	Data Type	Description
PlayerId	int	Unique player identifier.
ShirtNumber	string	Player shirt number.
IsCaptain	bool	Indicates if the player is team captain.
IsStartingLineup	bool	Indicates if the player is in the starting lineup.
Position	object	Player's playing position (Id, Name). Values are sport-specific. See Player Position for all values.
State	object	Player state (e.g. Active, Injured) (Id, Name).
Player	object	Full player profile. See Player.

Player Position

Element	Data Type	Description
Id	int	Unique identifier representing the player position. Values are sport-specific. See Player Position for all values.
Name	string	The name of the player position.

Player State

Element	Data Type	Description
ID	int	Unique identifier representing the player state.
Name	string	The name of the player state.

Player

Element	Data Type	Description
Id	int	Unique player identifier
Name	string	Player name
TeamId	int	ID of the player's team
NationalityId	int	Nationality identifier
BirthDate	string	Player birth date (ISO format)
Type	int	Player type 0 = Player
NationalityTeamId	int	National team identifier

Extra Data

Element	Data Type	Description
Value	string	Representing the extra data value
Name	string	The name of extra data field

Prediction Markets: For Prediction Markets fixtures, ExtraData on the fixture and on each entry in Participants includes an additional key. Note: the OutrightLeague model above lists this field as FixtureExtraData — in the JSON payload, both the fixture-level and each participant-level entry deliver it as ExtraData, exactly as shown in the "Predictions - JSON" example.

The value is a JSON-encoded string — parse it to access the underlying fields (title, rulebook_variables, etc.). See the "Predictions - JSON" example above.

See Prediction Markets for full context.

Key	Type	Description
Rules	string	Resolution criteria for this market or participant, as defined by the provider