Fixture

This documentation describes the complete structure of a Fixture Update message (Type 1) as delivered by TRADE.

{
  "Header": {
    "Type": 1,
    "MsgSeq": 2,
    "MsgGuid": "ea1da91b-fd6b-45ba-a2b2-14e3d771a070",
    "CreationDate": "2024-04-01T18:15:27.3452921Z",
    "ServerTimestamp": 1711995327345
  },
  "Body": {
    "Events": [
      {
        "FixtureId": 16861271,
        "Fixture": {
          "Subscription": {
            "Type": 1,
            "Status": 1
          },
          "Sport": {
            "Id": 6046,
            "Name": "Football"
          },
          "Location": {
            "Id": 248,
            "Name": "International"
          },
          "League": {
            "Id": 84379,
            "Name": "CAF World Cup Qualifiers"
          },
          "StartDate": "2025-10-08T19:00:00",
          "LastUpdate": "2025-10-08T04:33:17.898006",
          "Status": 1,
          "Participants": [
            {
              "Id": 228863,
              "Name": "Niger",
              "Position": "1"
            },
            {
              "Id": 52389636,
              "Name": "Republic of the Congo",
              "Position": "2"
            }
          ],
          "FixtureExtraData": [
            {
              "Name": "WithLivescore",
              "Value": "true"
            },
            {
              "Name": "WithInPlay",
              "Value": "true"
            },
            {
              "Name": "RotationNumbers",
              "Value": "132023,132022"
            }
          ],
          "Venue": {
            "Id": 5966,
            "Name": "Stade du 4-Août",
            "Capacity": 60000,
            "Attendance": 54000,
            "CourtSurfaceType": "Grass",
            "Environment": "Outdoors",
            "Assignment": "home",
            "Country": {
              "Id": 248,
              "Name": "International"
            },
            "State": {
              "Id": 61,
              "Name": "CA"
            },
            "City": {
              "Id": 3541,
              "Name": "Ouagadougou"
            }
          },
          "Stage": {
            "Id": 1,
            "Name": "Qualification"
          },
          "Round": {
            "Id": 32,
            "Name": "9"
          }
        },
        "Livescore": null,
        "Markets": null
      }
    ]
  }
}

Model

Events

Element

Data Type

Description

FixtureId

int

The unique ID of the fixture.

Fixture

int

Livescore

int

Markets

int

Markets

Fixture

Element

Data Type

Description

Subscription

object

Sport

object

Location

object

League

object

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

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

League

Element

Data Type

Description

Id

int

The unique ID of the league

Name

string

The name of the league

Participants

Element

Data Type

Description

Id

int

The unique ID of the participant

Name

string

The unique ID of the participant

Position

string

In 2-participant events the positions will be 1 (home) or 2 (away)

IsActive

bool

Will only show in outright events.

ExtraData

array

Array of data ExtraData

ExtraData

Element

Data Type

Description

Value

string

Representing the extra data value

Name

string

The name of extra data field

FixtureExtraData

Element

Data Type

Description

Value

string

Representing the extra data value

Name

string

The name of extra data field

Venue

Element

Data Type

Description

Id

string

The unique identifier of the venue where the fixture is held

Name

string

The official name of the venue where the fixture is held

Capacity

int

The maximum number of spectators that the venue can accommodate.

Attendance

int

The number of spectators present at the fixture.

CourtSurfaceType

string

The surface type for sports like tennis. Example: Grass, Clay, Hardcourt

Environment

string

Indicates if the venue is indoors or outdoors.

Assignment

string

Specifies whether the venue is assigned as Home, Away, or Neutral

Country

object

Contains the country details where the venue is located. Same values as Location

State

object

Contains the state or region details if applicable.

City

object

Contains the city details where the venue is located.

Country

Element

Data Type

Description

ID

int

Country unique identifier.

Name

string

Country name.

State

Element

Data Type

Description

ID

int

State unique identifier.

Name

string

State name.

City

Element

Data Type

Description

ID

int

City unique identifier.

Name

string

City name.

Stage

Element

Data Type

Description

ID

int

Unique identifier representing the competition stage.

Name

string

The name of the competition phase.

Round

Element

Data Type

Description

ID

int

Unique identifier representing the round within a competition.

Name

string

The official name of the round.

Last updated

Was this helpful?