Chat API

Conversate with the LLM using a fixture-based prompt.

post

Header parameters

Authorizationstringrequired

JWT token for authorization

Example: Bearer {jwt_token}

Languagestringrequired

Language code (e.g., "en" for English)

Example: en

Body

Promptstringoptional

The prompt or question for the LLM

Example: Who is likely to score first?

Fixtureobjectoptional

CorrelationIdstringoptional

Correlation ID for tracking the request

Example: abc123xyz

ConversationSessionIdstringoptional

Identifier for the conversation session

Example: session_12345

Responses

application/json

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://sec-gw.lsports.eu/chat/api/v2/chat' \
  --header 'Authorization: Bearer {jwt_token}' \
  --header 'Language: en' \
  --header 'Content-Type: application/json' \
  --data '{
    "Prompt": "Who is likely to score first?",
    "Fixture": {
      "Id": "22231141",
      "Date": "2024-10-27T14:00:00Z",
      "Participants": [
        {
          "Id": "Chelsea",
          "Name": "Chelsea",
          "DisplayName": "Chelsea FC"
        }
      ],
      "Markets": [
        {
          "Id": "1",
          "Name": "1X2",
          "DisplayName": "Match Result",
          "Bets": [
            {
              "Id": "1_2",
              "Name": "2",
              "Odds": 1.9,
              "Selected": false,
              "Line": "0.5",
              "DisplayName": "Away Win",
              "Player": {
                "Id": "101",
                "Name": "John Doe",
                "DisplayName": "J. Doe"
              }
            }
          ]
        }
      ],
      "League": {
        "Id": "67",
        "Name": "Premier League",
        "DisplayName": "EPL"
      },
      "Sport": {
        "Id": "1",
        "Name": "Football",
        "DisplayName": "Soccer"
      },
      "Location": {
        "Id": "701",
        "Name": "Old Trafford",
        "DisplayName": "Man Utd Stadium"
      }
    },
    "CorrelationId": "abc123xyz",
    "ConversationSessionId": "session_12345"
  }'

200

400

401

500

200

{
  "Message": {
    "Id": "269598d9-9af4-41ba-bc3a-18488e8912ab",
    "Type": "received",
    "Status": "delivered",
    "Timestamp": "2024-10-15T11:21:42",
    "Text": "How can I help you today?",
    "BetId": null,
    "MarketId": null,
    "PlayerId": null,
    "FixtureId": "22231141",
    "LSportsFixtureId": 22231141,
    "LSportsSportId": 6046,
    "LSportsLocationId": 243,
    "LSportsPlayerId": null
  },
  "RelatedQuestions": [
    "What are the odds for Chelsea to win?"
  ],
  "Error": 3
}

Successfully received response from LLM

Retrieves supported LSports market IDs for conversation.

post

Header parameters

Authorizationstringrequired

JWT token for authorization

Example: Bearer {jwt_token}

Body

Fixtureobjectoptional

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://sec-gw.lsports.eu/chat/api/v2/suggestedquestions' \
  --header 'Authorization: Bearer {jwt_token}' \
  --header 'Content-Type: application/json' \
  --data '{
    "Fixture": {
      "Id": "22231141",
      "Date": "2024-10-27T14:00:00Z",
      "Participants": [
        {
          "Id": "Chelsea",
          "Name": "Chelsea",
          "DisplayName": "Chelsea FC"
        }
      ],
      "Markets": [
        {
          "Id": "1",
          "Name": "1X2",
          "DisplayName": "Match Result",
          "Bets": [
            {
              "Id": "1_2",
              "Name": "2",
              "Odds": 1.9,
              "Selected": false,
              "Line": "0.5",
              "DisplayName": "Away Win",
              "Player": {
                "Id": "101",
                "Name": "John Doe",
                "DisplayName": "J. Doe"
              }
            }
          ]
        }
      ],
      "League": {
        "Id": "67",
        "Name": "Premier League",
        "DisplayName": "EPL"
      },
      "Sport": {
        "Id": "1",
        "Name": "Football",
        "DisplayName": "Soccer"
      },
      "Location": {
        "Id": "701",
        "Name": "Old Trafford",
        "DisplayName": "Man Utd Stadium"
      }
    }
  }'

200

400

401

500

200

[
  "52",
  "1002",
  "950"
]

Successfully retrieved list of supported LSports market IDs.

Retrieve supported fixtures for conversation.

post

Header parameters

Authorizationstringrequired

JWT token for authorization

Example: Bearer {jwt_token}

Body

Fixturesobject[]optional

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://sec-gw.lsports.eu/chat/api/v2/fixtures' \
  --header 'Authorization: Bearer {jwt_token}' \
  --header 'Content-Type: application/json' \
  --data '{
    "Fixtures": [
      {
        "Id": "22231141",
        "Date": "2024-10-27T14:00:00Z",
        "Participants": [
          {
            "Id": "Chelsea",
            "Name": "Chelsea",
            "DisplayName": "Chelsea FC"
          }
        ],
        "Markets": [
          {
            "Id": "1",
            "Name": "1X2",
            "DisplayName": "Match Result",
            "Bets": [
              {
                "Id": "1_2",
                "Name": "2",
                "Odds": 1.9,
                "Selected": false,
                "Line": "0.5",
                "DisplayName": "Away Win",
                "Player": {
                  "Id": "101",
                  "Name": "John Doe",
                  "DisplayName": "J. Doe"
                }
              }
            ]
          }
        ],
        "League": {
          "Id": "67",
          "Name": "Premier League",
          "DisplayName": "EPL"
        },
        "Sport": {
          "Id": "1",
          "Name": "Football",
          "DisplayName": "Soccer"
        },
        "Location": {
          "Id": "701",
          "Name": "Old Trafford",
          "DisplayName": "Man Utd Stadium"
        }
      }
    ]
  }'

200

400

401

500

200

{
  "Fixtures": [
    {
      "Id": "22231141",
      "Date": "2024-10-27T14:00:00Z",
      "FixtureId": "22231141",
      "LSportsFixtureId": 22231141,
      "LSportsSportId": 6046,
      "LSportsLocationId": 243
    }
  ]
}

Successfully retrieved supported fixtures for conversation.