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

POST undefined/PreMatch/GetEvents

chevron-rightExample of 'Prematch/GetEvents'hashtag

POST undefined/PreMatch/GetFixtureMarkets

chevron-rightExample OF 'Prematch/GetFixtureMarkets'hashtag

POST undefined/PreMatch/GetFixtures

chevron-rightExample of 'Prematch/GetFixtures' (JSON)hashtag

POST undefined/PreMatch/GetScores

chevron-rightExample of '/PreMatch/GetScores'hashtag

POST undefined/PreMatch/GetOutrightEvents

chevron-rightExample of '/PreMatch/GetOutrightEvents'hashtag

POST undefined/PreMatch/GetOutrightFixture

chevron-rightExample of '/PreMatch/GetOutrightFixture'hashtag

POST undefined/PreMatch/GetOutrightLeagues

chevron-rightExample of '/PreMatch/GetOutrightLeague'hashtag

POST undefined/PreMatch/GetOutrightLeagueMarkets

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
chevron-right
200

Success

No content

post
/PreMatch/GetOutrightLeagueEvents
200

Success

No content

chevron-rightExample of 'PreMatch/GetOutrightLeagueMarkets'hashtag

POST undefined/PreMatch/GetOutrightFixtureMarkets

chevron-rightExample of '/PreMatch/GetOutrightFixtureMarkets'hashtag

POST undefined/PreMatch/GetOutrightScores

Inplay Snapshot

POST undefined/InPlay/GetEvents

chevron-rightExample of '/InPlay/GetEvents'hashtag

POST undefined/InPlay/GetFixtureMarkets

chevron-rightExample of '/InPlay/GetFixtureMarkets'hashtag

POST undefined/InPlay/GetFixtures

chevron-rightExample of '/InPlay/GetFixtures'hashtag

POST undefined/InPlay/GetScores

chevron-rightExample of '/InPlay/GetScores'hashtag

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
chevron-right
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
chevron-right
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
chevron-right
200

Success

No content

post
/InPlay/GetOutrightLeagueEvents
200

Success

No content

Last updated

Was this helpful?