For the complete documentation index, see llms.txt. This page is also available as Markdown.

Getting Started

Receive your credentials and enable your data distribution

Receive your credentials from LSports, then enable your data distribution.

Step 1: Receive Your Credentials

LSports will provide your login credentials: Username, Password, and Package ID. These identify your account and package when calling the Distribution API and connecting to RabbitMQ. Store them securely: you'll use them in both places.

Step 2: Enable Distribution

Distribution must be explicitly enabled before you can consume messages. This is an API call, not a one-time toggle: you'll use the Start/Stop endpoints any time you need to pause or resume your feed, including as part of the recovery sequence covered in Reliability & Recovery.

Request endpoints

  • Enable: https://stm-api.lsports.eu/Distribution/Start

  • Disable: https://stm-api.lsports.eu/Distribution/Stop

Request body

{
    "PackageId": "YOUR_PACKAGE_ID",
    "UserName": "YOUR_USERNAME",
    "Password": "YOUR_PASSWORD"
}

Response

Keep watching it: Distribution Status API

Once distribution is running, poll the Distribution Status API regularly rather than treating it as fire-and-forget: it's your earliest warning that something on your consumption side is falling behind.

Metric
What to watch for

Polling frequency

Every ~5 seconds, within rate limits

Distribution active status

Should read true; false means distribution has stopped and you must start the recovery sequence in Reliability & Recovery

Consumers connected

Shows how many consumers are attached to your queue; confirms your consumer is actually connected and helps spot unexpected extra or missing consumers

Messages per second

Baseline this so you can spot drops or spikes

Messages in queue

The critical metric, see thresholds below

Queue depth
Meaning / action

0 messages

Target state: you're consuming as fast as data arrives

500+ messages (5-second window)

Investigate consumer performance immediately

10,000 unconsumed messages

Queue auto-shuts down: suspend trading and run full recovery


Next: Connection Setup

Last updated

Was this helpful?