LogoLogo
FeedsIntelligenceEngagementsHelpHome
OddsService
OddsService
  • General
    • Connection and Consumption setup
    • In-Play
    • Prematch Feed
    • API Reference
    • XML Structure
  • Enumerations
    • Message Types
    • Competition Types
    • Fixture/Scoreboard Status
    • Periods
    • Statistics and Incidents
    • Bet Settlement
    • Bet Status
  • Other Languages
    • Connecting to LSports - Portuguese
    • Connecting to LSports - Korean
    • Connecting to LSports - Chinese
    • Connecting to LSports - Japanese
    • Connecting to LSports - Spanish
Powered by GitBook
On this page
  • GetSports
  • GetLocations
  • GetLeagues
  • GetBookmakers
  • GetMarkets
  • API Notes and troubleshooting

Was this helpful?

  1. General

API Reference

PreviousPrematch FeedNextXML Structure

Last updated 9 months ago

Was this helpful?

GetSports

To receive a list of supported sports

Parameter breakdown

Action

Description

Optional Field

Username

Username as it apparrs in the package

X

Password

Password as it appears the package

X

Guid

GUID as it appears the package

X

Lang

Response content language Default value: English

✓

Indented

Response content will be indented Default value: False

✓

Response Scheme

<xs:element name="Feed">
   <xs:complexType>
     <xs:sequence>
         <xs:element name="MessageHeader">
           <xs:complexType>
               <xs:sequence>
                 <xs:element name="Type" type="xs:int"></xs:element>
                 <xs:element name="ServerTimestamp" type="xs:int"></xs:element>
               </xs:sequence>
           </xs:complexType>
         </xs:element>
         <xs:element name="Body">
           <xs:complexType>
               <xs:sequence>
                 <xs:element name="Sport" maxOccurs="unbounded">
                     <xs:complexType>
                       <xs:attribute name="Id" type="xs:int"></xs:attribute>
                       <xs:attribute name="Name" type="xs:string"></xs:attribute>
                     </xs:complexType>
                 </xs:element>
               </xs:sequence>
           </xs:complexType>
         </xs:element>
    </xs:sequence>
   </xs:complexType>
</xs:element>

GetLocations

To receive a list of supported locations

Parameter breakdown

Parameter

Description

Optional Field

Username

Username as it apparrs in the package

X

Password

Password as it appears the package

X

Guid

GUID as it appears the package

X

Lang

Response content language Default value: English

✓

Indented

Response content will be indented Default value: False

✓

Response Scheme

 <xs:element name="Feed">
  <xs:complexType>
    <xs:sequence>
      <xs:element name="MessageHeader">
        <xs:complexType>
          <xs:sequence>
            <xs:element name="Type" type="xs:int"/>
            <xs:element name="ServerTimestamp" type="xs:int"/>
          </xs:sequence>
        </xs:complexType>
      </xs:element>
      <xs:element name="Body">
        <xs:complexType>
          <xs:sequence>
            <xs:element name="Location" maxOccurs="unbounded">
              <xs:complexType>
                <xs:attribute name="Id" type="xs:int"/>
                <xs:attribute name="Name" type="xs:string"/>
              </xs:complexType>
            </xs:element>
          </xs:sequence>
        </xs:complexType>
      </xs:element>
    </xs:sequence>
  </xs:complexType>
</xs:element>

GetLeagues

To receive a list of supported leagues

Parameter breakdown

Parameter

Description

Optional Field

Username

Username as it appaers in the package

X

Password

Password as it appears the package

X

Guid

GUID as it appears the package

X

Sports

Comma separated list of sports Default value: Leagues from all sports

✓

Locations

Comma separated list of locations Default value: Leagues from all locations

✓

Lang

Response content language Default value: English

✓

Indented

Response content will be indented Default value: False

✓

Response Scheme

 <xs:element name="Feed">
  <xs:complexType>
    <xs:sequence>
      <xs:element name="MessageHeader">
        <xs:complexType>
          <xs:sequence>
            <xs:element name="Type" type="xs:int"/>
            <xs:element name="ServerTimestamp" type="xs:int"/>
          </xs:sequence>
        </xs:complexType>
      </xs:element>
      <xs:element name="Body">
        <xs:complexType>
          <xs:sequence>
            <xs:element name="League" maxOccurs="unbounded">
              <xs:complexType>
                <xs:attribute name="Id" type="xs:int"/>
                <xs:attribute name="Name" type="xs:string"/>
              </xs:complexType>
            </xs:element>
          </xs:sequence>
        </xs:complexType>
      </xs:element>
    </xs:sequence>
  </xs:complexType>
</xs:element>

GetBookmakers

To receive a list of supported bookmakers

Parameter breakdown

Parameter

Description

Optional Field

Username

Username as it apparrs in the package

X

Password

Password as it appears the package

X

Guid

GUID as it appears the package

X

Response content language Default value: English

✓

Indented

Response content will be indented Default value: False

✓

Response Scheme

<xs:element name="Feed">
  <xs:complexType>
    <xs:sequence>
      <xs:element name="MessageHeader">
        <xs:complexType>
          <xs:sequence>
            <xs:element name="Type" type="xs:int"/>
            <xs:element name="ServerTimestamp" type="xs:int"/>
          </xs:sequence>
        </xs:complexType>
      </xs:element>
      <xs:element name="Body">
        <xs:complexType>
          <xs:sequence>
            <xs:element name="Bookmaker" maxOccurs="unbounded">
              <xs:complexType>
                <xs:attribute name="Id" type="xs:int"/>
                <xs:attribute name="Name" type="xs:string"/>
              </xs:complexType>
            </xs:element>
          </xs:sequence>
        </xs:complexType>
      </xs:element>
    </xs:sequence>
  </xs:complexType>
</xs:element>

GetMarkets

To receive a list of supported markets

Parameter breakdown

Parameter

Description

Optional Field

Username

Username as it apparrs in the package

X

Password

Password as it appears the package

X

Guid

GUID as it appears the package

X

Lang

Response content language Default value: English

✓

Indented

Response content will be indented Default value: False

✓

Response Scheme

<xs:element name="Feed">
   <xs:complexType>
     <xs:sequence>
         <xs:element name="MessageHeader">
           <xs:complexType>
               <xs:sequence>
                 <xs:element name="Type" type="xs:int"></xs:element>
                 <xs:element name="ServerTimestamp" type="xs:int"></xs:element>
               </xs:sequence>
           </xs:complexType>
         </xs:element>
         <xs:element name="Body">
           <xs:complexType>
               <xs:sequence>
                 <xs:element name="Market" maxOccurs="unbounded">
                     <xs:complexType>
                       <xs:attribute name="Id" type="xs:int"></xs:attribute>
                       <xs:attribute name="Name" type="xs:string"></xs:attribute>
                     </xs:complexType>
                 </xs:element>
               </xs:sequence>
           </xs:complexType>
         </xs:element>
     </xs:sequence>
   </xs:complexType>
</xs:element>

API Notes and troubleshooting

Follow the below limitations and restrictions while working with LSports API

Be advised of the following limitations:

  • 2500 requests within 5 minutes per IP

We highly recommend using only filtered requests, otherwise, 'full' requests can take longer to retrieve, and in some cases, you won't be able to retrieve requests at all due to the vast amount of data.

Here are examples of "full" and "filtered" requests

API data preservation:

  • How long do we keep data available for Prematch? - 36 Hours as of the event's final status.

  • How long do we keep data available for the Inplay snapshot? - 8 Hours as of the event's final status.

Handling Special Characters in GET Requests

When making GET requests via the browser, encoding special characters is important. Failure to do so will result in the request failing. Ensure all special characters are properly encoded before sending the request.

Full -

Filtered -

https://prematch.lsports.eu/OddService/GetSports
https://prematch.lsports.eu/OddService/GetLocations
https://prematch.lsports.eu/OddService/GetLeagues
https://prematch.lsports.eu/OddService/GetBookmakers
https://prematch.lsports.eu/OddService/GetMarkets
http://prematch.lsports.eu/OddService/GetFixtures?username=YourEmail&Password=YourPassword&guid=3faaa32d-662b-4135-b1e2-38454263dcad
http://prematch.lsports.eu/OddService/GetFixtures?username=YourEmail&Password=YourPassword&guid=3fa1a30d-662b-4135-b1e2-38454263dcad&sports=6046&location=242
Lang