Snapshot

The Snapshot API is designed to provide real-time, comprehensive data snapshots of ongoing sports events. This API allows you to request detailed information about live events, enabling you to capture the current state of a fixture, including live scores, markets, and settlement data.

The Snapshot API should be used primarily when you are not in sync with the RabbitMQ feed. It serves as a fallback mechanism to ensure you can access the latest data when needed.

How to Use the Snapshot API

You can request a snapshot from our API service using the following endpoint:

Method: POST URL: https://stm-snapshot.lsports.eu/InPlay/{action}

Request Limitations

  • Full Requests Without Filters: Allowed once every 15 seconds.

  • Filtered Requests: Allowed once per second.

  • Fixture Snapshot Availability: Snapshots for fixtures that ended more than 24 hours before the request will not be available.

  • General API Call Limit: Limited to 1 call per second for all types of requests combined.

Time Filtering Behavior

The API supports three filtering parameters:

  • fromDate and toDate filter fixtures by their scheduled start date. If you don’t set them, you get all the fixtures.

  • timestamp filters only the markets and settlements updated since the specified time.

These filters are independent. Here’s how they work together:

  • If you set fromDate/toDate without timestamp, you receive all data (live scores, markets, settlements) for fixtures within the date range.

  • If you set fromDate/toDate and timestampy,you get those fixtures, but only the markets and settlements changed since the timestamp.

  • If you set only timestamp,you get all fixtures, but again, only updated markets and settlements are included (fixtures without any changes will still be returned, but without market data).

Best Practice

For recovery purposes, it is recommended to use only the timestamp filter, so you receive all updates since the time your system lost connection.

Prematch Snapshot

Retrieve Prematch Events

post

Used to provide snapshot messages for all types (fixture, livescore, markets, and settlements), This endpoint should only be used in case of data loss. It is recommended to use filters such as sport, location, league, or specific fixture to narrow down the results.

Body
userNamestring · min: 1Required
passwordstring · min: 1Required
packageIdinteger · int32Required
sportsinteger · int32[]Optional
locationsinteger · int32[]Optional
leaguesinteger · int32[]Optional
fixturesinteger · int32[]Optional
fromDateinteger · int64 | nullableOptional
toDateinteger · int64 | nullableOptional
timestampinteger · int64 | nullableOptional
marketsinteger · int32[]Optional
Responses
200

Success

No content

post
/PreMatch/GetEvents
200

Success

No content

Example of 'Prematch/GetEvents'

Retrieves markets for pre-match fixtures.

post
Body
userNamestring · min: 1Required
passwordstring · min: 1Required
packageIdinteger · int32Required
sportsinteger · int32[]Optional
locationsinteger · int32[]Optional
leaguesinteger · int32[]Optional
fixturesinteger · int32[]Optional
fromDateinteger · int64 | nullableOptional
toDateinteger · int64 | nullableOptional
timestampinteger · int64 | nullableOptional
Responses
200

Success

No content

post
/PreMatch/GetFixtureMarkets
200

Success

No content

Example OF 'Prematch/GetFixtureMarkets'

Retrieves pre-match fixtures for specific sports, locations, and leagues.

post
Body
userNamestring · min: 1Required
passwordstring · min: 1Required
packageIdinteger · int32Required
sportsinteger · int32[]Optional
locationsinteger · int32[]Optional
leaguesinteger · int32[]Optional
fixturesinteger · int32[]Optional
fromDateinteger · int64 | nullableOptional
toDateinteger · int64 | nullableOptional
timestampinteger · int64 | nullableOptional
Responses
200

Success

No content

post
/PreMatch/GetFixtures
200

Success

No content

Example of 'Prematch/GetFixtures' (JSON)

Retrieves pre-match scores for specific sports, locations, and leagues.

post
Body
userNamestring · min: 1Required
passwordstring · min: 1Required
packageIdinteger · int32Required
sportsinteger · int32[]Optional
locationsinteger · int32[]Optional
leaguesinteger · int32[]Optional
fixturesinteger · int32[]Optional
fromDateinteger · int64 | nullableOptional
toDateinteger · int64 | nullableOptional
timestampinteger · int64 | nullableOptional
Responses
200

Success

No content

post
/PreMatch/GetScores
200

Success

No content

Example of '/PreMatch/GetScores'

Retrieves pre-match outright events for specific sports.

post
Body
userNamestring · min: 1Required
passwordstring · min: 1Required
packageIdinteger · int32Optional
sportsinteger · int32[] | nullableOptional
locationsinteger · int32[] | nullableOptional
fixturesinteger · int32[] | nullableOptional
marketsinteger · int32[] | nullableOptional
tournamentsinteger · int32[] | nullableOptional
fromDateinteger · int64 | nullableOptional
toDateinteger · int64 | nullableOptional
timestampinteger · int64 | nullableOptional
Responses
200

Success

No content

post
/PreMatch/GetOutrightEvents
200

Success

No content

Example of '/PreMatch/GetOutrightEvents'

Retrieves pre-match outright fixture for specific sports, locations, and leagues.

post
Body
userNamestring · min: 1Required
passwordstring · min: 1Required
packageIdinteger · int32Optional
sportsinteger · int32[] | nullableOptional
locationsinteger · int32[] | nullableOptional
fixturesinteger · int32[] | nullableOptional
tournamentsinteger · int32[] | nullableOptional
fromDateinteger · int64 | nullableOptional
toDateinteger · int64 | nullableOptional
timestampinteger · int64 | nullableOptional
Responses
200

Success

No content

post
/PreMatch/GetOutrightFixture
200

Success

No content

Example of '/PreMatch/GetOutrightFixture'

Retrieves pre-match outright leagues for specific sports.

post
Body
userNamestring · min: 1Required
passwordstring · min: 1Required
packageIdinteger · int32Optional
sportsinteger · int32[] | nullableOptional
locationsinteger · int32[] | nullableOptional
leaguesinteger · int32[] | nullableOptional
fixturesinteger · int32[] | nullableOptional
fromDateinteger · int64 | nullableOptional
toDateinteger · int64 | nullableOptional
timestampinteger · int64 | nullableOptional
Responses
200

Success

No content

post
/PreMatch/GetOutrightLeagues
200

Success

No content

Example of '/PreMatch/GetOutrightLeague'

Retrieves markets for pre-match outright leagues.

post
Body
userNamestring · min: 1Required
passwordstring · min: 1Required
packageIdinteger · int32Optional
sportsinteger · int32[] | nullableOptional
locationsinteger · int32[] | nullableOptional
leaguesinteger · int32[] | nullableOptional
fixturesinteger · int32[] | nullableOptional
marketsinteger · int32[] | nullableOptional
fromDateinteger · int64 | nullableOptional
toDateinteger · int64 | nullableOptional
timestampinteger · int64 | nullableOptional
Responses
200

Success

No content

post
/PreMatch/GetOutrightLeagueMarkets
200

Success

No content

post
Body
userNamestring | nullableOptional
passwordstring | nullableOptional
packageIdinteger · int32Optional
errorMessagestring | nullableRead-onlyOptional
stampstring · uuidOptional
platformTypeinteger · enumOptionalPossible values:
sportsinteger · int32[] | nullableOptional
sportsToRetrieveinteger · int32[] | nullableRead-onlyOptional
locationsinteger · int32[] | nullableOptional
locationsToRetrieveinteger · int32[] | nullableRead-onlyOptional
leaguesinteger · int32[] | nullableOptional
leaguesToRetriveinteger · int32[] | nullableRead-onlyOptional
fixturesinteger · int32[] | nullableOptional
fixturesToRetrieveinteger · int32[] | nullableRead-onlyOptional
marketsinteger · int32[] | nullableOptional
marketsToRetrieveinteger · int32[] | nullableRead-onlyOptional
timestampinteger · int64 | nullableOptional
fromDateinteger · int64 | nullableOptional
toDateinteger · int64 | nullableOptional
guidstring · uuidOptional
requestTypeinteger · enumOptionalPossible values:
requestedFromDatestring · date-time | nullableRead-onlyOptional
requestedToDatestring · date-time | nullableRead-onlyOptional
requestedTimestampstring · date-time | nullableRead-onlyOptional
tournamentsinteger · int32[] | nullableOptional
isOutrightbooleanOptional
Responses
200

Success

No content

post
/PreMatch/GetOutrightLeagueEvents
200

Success

No content

Example of 'PreMatch/GetOutrightLeagueMarkets'

Retrieves markets for pre-match outright fixtures.

post
Body
userNamestring · min: 1Required
passwordstring · min: 1Required
packageIdinteger · int32Optional
sportsinteger · int32[] | nullableOptional
locationsinteger · int32[] | nullableOptional
fixturesinteger · int32[] | nullableOptional
marketsinteger · int32[] | nullableOptional
tournamentsinteger · int32[] | nullableOptional
fromDateinteger · int64 | nullableOptional
toDateinteger · int64 | nullableOptional
timestampinteger · int64 | nullableOptional
Responses
200

Success

No content

post
/PreMatch/GetOutrightFixtureMarkets
200

Success

No content

Example of '/PreMatch/GetOutrightFixtureMarkets'

Retrieves pre-match outright scores for specific sports.

post
Body
userNamestring · min: 1Required
passwordstring · min: 1Required
packageIdinteger · int32Optional
sportsinteger · int32[] | nullableOptional
locationsinteger · int32[] | nullableOptional
fixturesinteger · int32[] | nullableOptional
tournamentsinteger · int32[] | nullableOptional
fromDateinteger · int64 | nullableOptional
toDateinteger · int64 | nullableOptional
timestampinteger · int64 | nullableOptional
Responses
200

Success

No content

post
/PreMatch/GetOutrightScores
200

Success

No content

Inplay Snapshot

Retrieves in-play events for specific sports.

post

Used to provide snapshot messages for all types (fixture, livescore, markets, and settlements), This endpoint should only be used in case of data loss. It is recommended to use filters such as sport, location, league, or specific fixture to narrow down the results.

Body
userNamestring · min: 1Required
passwordstring · min: 1Required
packageIdinteger · int32Required
sportsinteger · int32[]Optional
locationsinteger · int32[]Optional
leaguesinteger · int32[]Optional
fixturesinteger · int32[]Optional
fromDateinteger · int64 | nullableOptional
toDateinteger · int64 | nullableOptional
timestampinteger · int64 | nullableOptional
marketsinteger · int32[]Optional
Responses
200

Success

No content

post
/InPlay/GetEvents
200

Success

No content

Example of '/InPlay/GetEvents'

Retrieves markets for in-play fixtures.

post
Body
userNamestring · min: 1Required
passwordstring · min: 1Required
packageIdinteger · int32Required
sportsinteger · int32[]Optional
locationsinteger · int32[]Optional
leaguesinteger · int32[]Optional
fixturesinteger · int32[]Optional
fromDateinteger · int64 | nullableOptional
toDateinteger · int64 | nullableOptional
timestampinteger · int64 | nullableOptional
Responses
200

Success

No content

post
/InPlay/GetFixtureMarkets
200

Success

No content

Example of '/InPlay/GetFixtureMarkets'

Retrieves in-play fixtures for specific sports, locations, and leagues.

post
Body
userNamestring · min: 1Required
passwordstring · min: 1Required
packageIdinteger · int32Required
sportsinteger · int32[]Optional
locationsinteger · int32[]Optional
leaguesinteger · int32[]Optional
fixturesinteger · int32[]Optional
fromDateinteger · int64 | nullableOptional
toDateinteger · int64 | nullableOptional
timestampinteger · int64 | nullableOptional
Responses
200

Success

No content

post
/InPlay/GetFixtures
200

Success

No content

Example of '/InPlay/GetFixtures'

Retrieves in-play scores for specific sports, locations, and leagues.

post
Body
userNamestring · min: 1Required
passwordstring · min: 1Required
packageIdinteger · int32Required
sportsinteger · int32[]Optional
locationsinteger · int32[]Optional
leaguesinteger · int32[]Optional
fixturesinteger · int32[]Optional
fromDateinteger · int64 | nullableOptional
toDateinteger · int64 | nullableOptional
timestampinteger · int64 | nullableOptional
Responses
200

Success

No content

post
/InPlay/GetScores
200

Success

No content

Example of '/InPlay/GetScores'

Outright Inplay Snapshot

post
Body
userNamestring | nullableOptional
passwordstring | nullableOptional
packageIdinteger · int32Optional
errorMessagestring | nullableRead-onlyOptional
stampstring · uuidOptional
platformTypeinteger · enumOptionalPossible values:
sportsinteger · int32[] | nullableOptional
sportsToRetrieveinteger · int32[] | nullableRead-onlyOptional
locationsinteger · int32[] | nullableOptional
locationsToRetrieveinteger · int32[] | nullableRead-onlyOptional
leaguesinteger · int32[] | nullableOptional
leaguesToRetriveinteger · int32[] | nullableRead-onlyOptional
fixturesinteger · int32[] | nullableOptional
fixturesToRetrieveinteger · int32[] | nullableRead-onlyOptional
marketsinteger · int32[] | nullableOptional
marketsToRetrieveinteger · int32[] | nullableRead-onlyOptional
timestampinteger · int64 | nullableOptional
fromDateinteger · int64 | nullableOptional
toDateinteger · int64 | nullableOptional
guidstring · uuidOptional
requestTypeinteger · enumOptionalPossible values:
requestedFromDatestring · date-time | nullableRead-onlyOptional
requestedToDatestring · date-time | nullableRead-onlyOptional
requestedTimestampstring · date-time | nullableRead-onlyOptional
tournamentsinteger · int32[] | nullableOptional
isOutrightbooleanOptional
Responses
200

Success

No content

post
/InPlay/GetOutrightLeagues
200

Success

No content

post
Body
userNamestring | nullableOptional
passwordstring | nullableOptional
packageIdinteger · int32Optional
errorMessagestring | nullableRead-onlyOptional
stampstring · uuidOptional
platformTypeinteger · enumOptionalPossible values:
sportsinteger · int32[] | nullableOptional
sportsToRetrieveinteger · int32[] | nullableRead-onlyOptional
locationsinteger · int32[] | nullableOptional
locationsToRetrieveinteger · int32[] | nullableRead-onlyOptional
leaguesinteger · int32[] | nullableOptional
leaguesToRetriveinteger · int32[] | nullableRead-onlyOptional
fixturesinteger · int32[] | nullableOptional
fixturesToRetrieveinteger · int32[] | nullableRead-onlyOptional
marketsinteger · int32[] | nullableOptional
marketsToRetrieveinteger · int32[] | nullableRead-onlyOptional
timestampinteger · int64 | nullableOptional
fromDateinteger · int64 | nullableOptional
toDateinteger · int64 | nullableOptional
guidstring · uuidOptional
requestTypeinteger · enumOptionalPossible values:
requestedFromDatestring · date-time | nullableRead-onlyOptional
requestedToDatestring · date-time | nullableRead-onlyOptional
requestedTimestampstring · date-time | nullableRead-onlyOptional
tournamentsinteger · int32[] | nullableOptional
isOutrightbooleanOptional
Responses
200

Success

No content

post
/InPlay/GetOutrightLeagueMarkets
200

Success

No content

post
Body
userNamestring | nullableOptional
passwordstring | nullableOptional
packageIdinteger · int32Optional
errorMessagestring | nullableRead-onlyOptional
stampstring · uuidOptional
platformTypeinteger · enumOptionalPossible values:
sportsinteger · int32[] | nullableOptional
sportsToRetrieveinteger · int32[] | nullableRead-onlyOptional
locationsinteger · int32[] | nullableOptional
locationsToRetrieveinteger · int32[] | nullableRead-onlyOptional
leaguesinteger · int32[] | nullableOptional
leaguesToRetriveinteger · int32[] | nullableRead-onlyOptional
fixturesinteger · int32[] | nullableOptional
fixturesToRetrieveinteger · int32[] | nullableRead-onlyOptional
marketsinteger · int32[] | nullableOptional
marketsToRetrieveinteger · int32[] | nullableRead-onlyOptional
timestampinteger · int64 | nullableOptional
fromDateinteger · int64 | nullableOptional
toDateinteger · int64 | nullableOptional
guidstring · uuidOptional
requestTypeinteger · enumOptionalPossible values:
requestedFromDatestring · date-time | nullableRead-onlyOptional
requestedToDatestring · date-time | nullableRead-onlyOptional
requestedTimestampstring · date-time | nullableRead-onlyOptional
tournamentsinteger · int32[] | nullableOptional
isOutrightbooleanOptional
Responses
200

Success

No content

post
/InPlay/GetOutrightLeagueEvents
200

Success

No content

Last updated

Was this helpful?