Tips Feed Integration

Welcome to the LSports Tips Feed Integration Guide !

Overview

LSports Tips Feed is a real-time betting insights distribution service that processes and delivers data-driven tips to customers through RabbitMQ.

It enables sportsbooks, affiliates, and media or analytics platforms to enhance user engagement and betting activity by providing timely, intelligence-backed recommendations that guide users toward the most relevant markets and deepen in-play interaction.

By automating the delivery of statistically validated tips across both PreMatch and InPlay events, the system empowers customers to drive betting volume, strengthen retention, and build user confidence — all while maintaining transparency and full control over the tip generation process.

The system supports:

PreMatch Tips — for scheduled fixtures
InPlay Tips — for live and ongoing events

Step 1: Access Credentials

Get your Username, Password, and CustomerPackageId from your CSM.

You will receive access to two RabbitMQ virtual hosts:

/fixtures – pre-event metadata
/tips – real-time tips (added/removed)

Step 2: Queue Provisioning

For each vhost, LSports provisions a queue per customer.

Queue name (both vhosts): _{CustomerPackageId}_

Encoding: UTF-8 JSON

Transport: AMQP 0-9-1 over TLS (port 5671)

Step 3: Establish Connections

Open two AMQP connections (one per vhost) and consume from the same queue name on each vhost:

/fixtures → _{CustomerPackageId}_
/tips → _{CustomerPackageId}_

Integration examples in C#, Python, and Java appear under Code Samples below.

Step 4: Data Mapping

Fixtures: subscribe to /fixtures and persist by body.fixtureId.

Delta updates only (messages are sent only on change).
Use add or update: unknown fixture ⇒ add; known fixture ⇒ update changed fields.

Tips: subscribe to /tips and correlate by body.fixtureId against your fixtures store.

Two message kinds: Added (1) and Removed (2).
For Added, you get full tip objects; for Removed, you get IDs to remove.

Message Structure

For each message type, fields that are null are omitted from the payload to deliver the lightest possible message.

Common Header

Field

Type

Nullable

Notes

MessageId

string (GUID)

Unique per message; UUID v4

Timestamp

ISO-8601 (UTC)

UTC

MessageType

int (enum)

1 = Fixture, 3 = Tips

Fixtures (shared contract)

{
  "header": {
    "MessageId": "d9e1a4e6-2a44-4a3d-9bbd-0a9a7f5e1c2d",
    "Timestamp": "2025-11-04T19:45:00Z",
    "MessageType": 1
  },
  "body": {
    "fixtureId": 123456,
    "status": 1,
    "startDate": "2025-11-04T19:45:00Z",
    "sport": { "id": 6046, "name": "Football" },
    "league": { "id": 1001, "name": "Premier League" },
    "location":{ "id": 250, "name": "England" },
    "participants": [
      { "id": 9001, "name": "Arsenal", "position": 1 },
      { "id": 9002, "name": "Chelsea", "position": 2 }
    ]
  }
}

Fields (body)

Field

Type

Nullable

Notes

fixtureId

int

Join key for tips/incidents

status

int (numeric enum)

See Fixture Status (numeric enum)

startDate

ISO-8601 (UTC)

Scheduled start

sport.id / sport.name

int / string

Sport metadata

league.id / league.name

int / string

League metadata

location.id / location.name

int / string

Country/venue

participants

array of Participant objects

Ordered by position (home/away)

Participant (object)

Field

Type

Nullable

Notes

int

Participant id

name

string

Participant name

position

int (numeric enum)

1 = home, 2 = away

Fixture Status (numeric enum)

Value

Name

Description

NSY

Fixture is in the pre-match phase (not started yet).

InProgress

Fixture is live and currently in play.

Finished

Fixture has ended and results are confirmed.

Cancelled

Event will not take place or requires recreation under a new Id.

Postponed

Fixture is postponed; may later return to NSY with an updated start time.

Interrupted

Temporarily stopped (e.g., weather); resumes under the same fixture Id.

Abandoned

Permanently stopped and will not resume.

LostCoverage

Coverage lost; may later become InProgress/Interrupted/Abandoned/Finished.

AboutToStart

Fixture is about to begin shortly.

Tips

Added Tips — Example (tipEventType = 1)

{
  "header": {
    "MessageId": "5f7a9d5a-44c0-4f1e-9d24-2a93d6e7b0a1",
    "Timestamp": "2025-11-04T19:50:00Z",
    "MessageType": 3,
    "tipEventType": 1
  },
  "body": {
    "fixtureId": 123456,
    "status": 2,
    "tips": [
      {
        "id": "TIP_001",
        "marketId": 1,
        "betName": "Match Winner",
        "line": "1.85",
        "text": "Home team to win",
        "playerId": 501,
        "isHomeTeamTip": true,
        "language": "en"
      }
    ]
  }
}

Fields — Added (tipEventType = 1)

Field

Type

Nullable

Notes

fixtureId

int

Join to fixtures

status

int (FixtureStatus)

Fixture status at update time

tips

array of Tip objects

Added/updated tips for this fixture

Tip (object)

Field

Type

Nullable

Notes

string

Tip id

marketId

int

Market identifier

betName

string

Market/bet label

line

string

Yes

Odds line or relevant value

text

string

Yes

Tip description

playerId

int

Yes

If applicable

isHomeTeamTip

bool

Yes

true = home, false = away/neutral

language

string

Yes

ISO language code (e.g., "en")

Removed Tips — Example (tipEventType = 2)

{
  "header": {
    "MessageId": "d8a17f3d-0f5b-4d0e-9d2d-2a1f4a8b9c3e",
    "Timestamp": "2025-11-04T19:52:00Z",
    "MessageType": 3,
    "tipEventType": 2
  },
  "body": {
    "fixtureId": 123456,
    "status": 2,
    "tips": ["TIP_001", "TIP_002"]
  }
}

Fields — Removed (tipEventType = 2)

Field

Type

Nullable

Notes

fixtureId

int

Join to fixtures

status

int (FixtureStatus)

Status at update time

tips

array of string

Tip IDs to remove

Code Samples

C# — Two vhosts / Same queue name

using RabbitMQ.Client;
using RabbitMQ.Client.Events;
using System.Text;

var fixturesFactory = new ConnectionFactory {
    HostName = "your-rabbitmq-host",
    Port = 5671,
    UserName = "fixtures-username",
    Password = "fixtures-password",
    VirtualHost = "fixtures",
    Ssl = new SslOption { Enabled = true, ServerName = "your-rabbitmq-host" }
};

using var fxConn = fixturesFactory.CreateConnection();
using var fxCh = fxConn.CreateModel();
string qname = $"_{customerPackageId}_";
fxCh.QueueDeclare(qname, durable: true, exclusive: false, autoDelete: false);

var tipsFactory = new ConnectionFactory {
    HostName = "your-rabbitmq-host",
    Port = 5671,
    UserName = "tips-username",
    Password = "tips-password",
    VirtualHost = "tips",
    Ssl = new SslOption { Enabled = true, ServerName = "your-rabbitmq-host" }
};

using var tpConn = tipsFactory.CreateConnection();
using var tpCh = tpConn.CreateModel();
tpCh.QueueDeclare(qname, durable: true, exclusive: false, autoDelete: false);

void Consume(IModel ch, string queue, Action<string> handle) {
    var consumer = new EventingBasicConsumer(ch);
    consumer.Received += (_, ea) => handle(Encoding.UTF8.GetString(ea.Body.ToArray()));
    ch.BasicConsume(queue: queue, autoAck: true, consumer: consumer);
}

Consume(fxCh, qname, json => {
    // Upsert fixture by body.fixtureId (delta-only)
});

Consume(tpCh, qname, json => {
    // Parse header.tipEventType: 1=Added, 2=Removed
    // Join by body.fixtureId; for Added: body.tips[] (Tip objects); for Removed: body.tips[] (IDs)
});

Python (pika) — Two vhosts / Same queue name

import ssl, pika, json, threading

def mk_conn(vhost, user, pwd):
    ctx = ssl.create_default_context()
    ctx.check_hostname = False
    ctx.verify_mode = ssl.CERT_NONE
    return pika.BlockingConnection(pika.ConnectionParameters(
        host='your-rabbitmq-host', port=5671, virtual_host=vhost,
        credentials=pika.PlainCredentials(user, pwd),
        ssl_options=pika.SSLOptions(ctx, server_hostname='your-rabbitmq-host')
    ))

def run_consumer(vhost, user, pwd, qname, on_message):
    conn = mk_conn(vhost, user, pwd)
    ch = conn.channel()
    ch.queue_declare(queue=qname, durable=True, exclusive=False, auto_delete=False)
    ch.basic_consume(queue=qname, on_message_callback=on_message, auto_ack=True)
    try:
        ch.start_consuming()
    finally:
        try: conn.close()
        except: pass

def on_fixture(ch, method, props, body):
    m = json.loads(body.decode('utf-8'))
    # upsert by m['body']['fixtureId']

def on_tip(ch, method, props, body):
    m = json.loads(body.decode('utf-8'))
    # kind = m['header'].get('tipEventType') # 1=Added, 2=Removed
    # if kind == 1: iterate Tip objects in m['body']['tips']
    # if kind == 2: remove IDs in m['body']['tips']

qname = f"_{customer_package_id}_"
t_fx = threading.Thread(target=run_consumer, args=('fixtures', 'fixtures-username', 'fixtures-password', qname, on_fixture), daemon=True)
t_tp = threading.Thread(target=run_consumer, args=('tips', 'tips-username', 'tips-password', qname, on_tip), daemon=True)
t_fx.start(); t_tp.start(); t_fx.join(); t_tp.join()

Java — Two vhosts / Same queue name

import com.rabbitmq.client.*;

String q = "_" + customerPackageId + "_";

// /fixtures
ConnectionFactory f1 = new ConnectionFactory();
f1.setHost("your-rabbitmq-host");
f1.setPort(5671);
f1.setUsername("fixtures-username");
f1.setPassword("fixtures-password");
f1.setVirtualHost("fixtures");
f1.useSslProtocol();

Connection fxConn = f1.newConnection();
Channel fxCh = fxConn.createChannel();
fxCh.queueDeclare(q, true, false, false, null);

// /tips
ConnectionFactory f2 = new ConnectionFactory();
f2.setHost("your-rabbitmq-host");
f2.setPort(5671);
f2.setUsername("tips-username");
f2.setPassword("tips-password");
f2.setVirtualHost("tips");
f2.useSslProtocol();

Connection tpConn = f2.newConnection();
Channel tpCh = tpConn.createChannel();
tpCh.queueDeclare(q, true, false, false, null);

DeliverCallback fxCb = (tag, d) -> {
    String json = new String(d.getBody(), "UTF-8");
    // upsert by body.fixtureId (delta-only)
};

DeliverCallback tpCb = (tag, d) -> {
    String json = new String(d.getBody(), "UTF-8");
    // parse header.tipEventType (1=Added, 2=Removed)
    // join by body.fixtureId
};

fxCh.basicConsume(q, true, fxCb, tag -> {});
tpCh.basicConsume(q, true, tpCb, tag -> {});

Tips Text Placeholder Replacement Rules

This page describes how placeholders inside Tip Text are dynamically replaced with fixture participant names based on the isHomeTeamTip flag.

1. `{participant}` Placeholder

The {participant} placeholder is dynamically replaced with one of the fixture teams. The selected team depends on the isHomeTeamTip property.

Replacement Logic

If isHomeTeamTip = true → {participant} = Home team
If isHomeTeamTip = false → {participant} = Away team

Received Tip

The sum of runs during the 9th inning was less than 2.5, in all of the last 10 away matches that {participant} trailed by the end of the 8th inning.

Example Resolution

Home Team: Boston Red Sox
Away Team: New York Yankees
isHomeTeamTip: false

Resolved Tip

The sum of runs during the 9th inning was less than 2.5, in all of the last 10 away matches that New York Yankees trailed by the end of the 8th inning.

2. `{participant}` and `{opponent}` Placeholders

Some tips contain both placeholders:

3 of the last 5 away meetings by {participant} against {opponent} ended with less than 14.5 runs.

Replacement Logic

Resolve {participant} using the same rule as before
Resolve {opponent} as the opposite team:
- If {participant} = Home → {opponent} = Away
- If {participant} = Away → {opponent} = Home

Example Resolution

Home Team: Los Angeles Dodgers
Away Team: San Diego Padres
isHomeTeamTip: true

Replacements:

{participant} → Los Angeles Dodgers
{opponent} → San Diego Padres

Resolved Tip

3 of the last 5 away meetings by Los Angeles Dodgers against San Diego Padres ended with less than 14.5 runs.

3. `{league}` Placeholder

The {league} placeholder is used in tips that reference historical performance within a specific competition or league. It should be replaced with the league name associated with the fixture (e.g., MLB, NFL, NBA, Premier League, etc.).

Replacement Logic

Replace {league} with the competition name of the current fixture. This field is taken directly from the fixture's metadata.

Example Tip

{participant} didn't lose in 3 of their last 10 matches played in {league}

Example Resolution

Home Team: Atlanta Braves
Away Team: Philadelphia Phillies
isHomeTeamTip: true
Fixture League: MLB

Replacements:

{participant} → Atlanta Braves
{league} → MLB

Resolved Tip

Atlanta Braves didn't lose in 3 of their last 10 matches played in MLB

4. `{player}` Placeholder

The {player} placeholder is used in tips that reference individual player performance. It must be replaced with the player name provided by the tip data model.

Replacement Logic

Replace {player} with the player's full name supplied in the tip payload.

{opponent} is replaced according to the existing team logic:

If isHomeTeamTip = true, {opponent} = Away team
If isHomeTeamTip = false, {opponent} = Home team

Example Tip

{player} scored a goal in 3 of his last 5 matches against {opponent}

Example Resolution

Home Team: Liverpool FC
Away Team: West Ham United
isHomeTeamTip: true
Player: Cody Gakpo

Replacements:

{player} → Cody Gakpo
{opponent} → West Ham United

Resolved Tip

Cody Gakpo scored a goal in 3 of his last 5 matches against West Ham United

PreviousChat API

Last updated 11 days ago

Was this helpful?

Good afternoon

Overview

Step 1: Access Credentials

Step 2: Queue Provisioning

Step 3: Establish Connections

Step 4: Data Mapping

Message Structure

Common Header

Fixtures (shared contract)

Tips

Code Samples

C# — Two vhosts / Same queue name

Python (pika) — Two vhosts / Same queue name

Java — Two vhosts / Same queue name

Tips Text Placeholder Replacement Rules

1. {participant} Placeholder

2. {participant} and {opponent} Placeholders

3. {league} Placeholder

4. {player} Placeholder

1. `{participant}` Placeholder

2. `{participant}` and `{opponent}` Placeholders

3. `{league}` Placeholder

4. `{player}` Placeholder