Message

Modified on Tue, 1 Mar, 2022 at 4:42 PM

The messages are structured as follows:

XML Example


<Message>
    <Header>
        ...
    </Header>
    <Body>
        ...
    </Body>
</Message>

Json Example

{
  "Message": {
    "Header": {
    ...
    },
    "Body": {
    ...
    }
  },
}

Header

The header consists of general information, which can be later used as a reference. It is structured as follows:

XML Example

<Header>
    <Type>2</Type>
    <MsgGuid>16c9746d-619e-4e42-b8e1-fb95251c3859</MsgGuid>
    <ServerTimestamp>1489578474</ServerTimestamp>
    <MsgSeq>1</MsgSeq>
</Header>

JSON Example

{
  "Header": {
    "Type": "2",
    "MsgGuid": "16c9746d-619e-4e42-b8e1-fb95251c3859",
    "ServerTimestamp": "1489578474",
    "MsgSeq": "1"
  },
}

Model

ElementData TypeDescription
TypeintThe type of the message
MsgGuidguidThe unique GUID of the message
ServerTimestamplongTimestamp representing the current time of when the message was sent
MsgSeqintThe message sequence. The sequence is not unique, it's a sequential per type of message. For example, every market has its own sequence, every livescore message has their own sequence, not related to market messages, every resulting message have their own sequence, etc.

Note: all timestamps are in UTC

Body

The body of the message holds all of the content. It is structured as follows:

XML Example

<Body>
    <Events>
        ...
    </Events>
    <Competition>
        ...
    </Competition>    
    <KeepAlive> 
        ...
    <KeepAlive>
</Body>

Json Example

{
  "Body": {
    "Events": {
    ...
    },
    "Competition": {
    ...
    },
    "KeepAlive": {
    ...
    }
  },
}

Model

ElementData TypeDescription
EventsArrayArray of Event
CompetitionArrayAn array of Competition -
Relevant for Outright MessageTypes
KeepAliveArrayAn array of active events – all the events that are live at the moment

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