Chat API

Conversate with the LLM using a fixture-based prompt.

post

/chat/api/v2/chat

Header parameters

Authorizationstringrequired

JWT token for authorization

Example: Bearer {jwt_token}

Languagestringrequired

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

Example: en

Body

Promptstring

The prompt or question for the LLM

Example: Who is likely to score first?

CorrelationIdstring

Correlation ID for tracking the request

Example: abc123xyz

ConversationSessionIdstring

Identifier for the conversation session

Example: session_12345

Fixtureobject

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?","CorrelationId":"abc123xyz","ConversationSessionId":"session_12345","Fixture":{"Id":"22231141","Date":"2024-10-27T14:00:00Z","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"},"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"}}]}]}}'

200

400

401

500

200

{
  "Error": 3,
  "RelatedQuestions": [
    "What are the odds for Chelsea to win?"
  ],
  "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
  }
}

Successfully received response from LLM

Retrieves supported LSports market IDs for conversation.

post

/chat/api/v2/suggestedquestions

Header parameters

Authorizationstringrequired

JWT token for authorization

Example: Bearer {jwt_token}

Body

Fixtureobject

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","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"},"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"}}]}]}}'

200

400

401

500

200

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

Successfully retrieved list of supported LSports market IDs.

Retrieve supported fixtures for conversation.

post

/chat/api/v2/fixtures

Header parameters

Authorizationstringrequired

JWT token for authorization

Example: Bearer {jwt_token}

Body

Fixturesobject[]

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","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"},"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"}}]}]}]}'

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.