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/toDatewithouttimestamp, you receive all data (live scores, markets, settlements) for fixtures within the date range.
If you set fromDate/toDateandtimestampy,you get those fixtures, but only the markets and settlements changed since the timestamp.
If you set onlytimestamp,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.
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.