Risk Home

API

This documentation describes the available API endpoints for bets and users

BET SLIP

IMPORTANT NOTE:

for more information about bet_to_check property in the POST /cart/place-bet refer to - Place Bet - bet_to_check structure

Place a bet slip

post

Place a bet slip - requires JWT token for authentication

Authorizations
Body
betContextstring · enumRequired

Context of the bet

Example: prematchPossible values:
bet_to_checkstringRequired

Bet data to be validated and placed (stringified JSON)

Example: stringified json from Betting platform
langstringRequired

Language preference for the response

Example: en
accept_oddsbooleanRequired

Whether to accept current odds or not

Example: true
hashstringRequired

Security hash for bet validation

Example: U2FsdGVkX19EtRS0QDFGSD8O08YDKCTDFWA1HXFKG8dv4cf6th0DhRwukzSQ7isCCxP
type_userstringRequired

Type of user placing the bet

Example: user
Responses
200

Bet placed successfully

application/json
post
POST /cart/place-bet HTTP/1.1
Host: rms-bet-api.lsports.eu
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 1830

{
  "betContext": "prematch",
  "bet_to_check": "{\"odds_sources\":[\"4459816548;2666973288;4273848547\"],\"bet\":{\"odds\":[{\"id_market\":2666973288,\"market_unique_id\":\"2666973288\",\"market_name\":\"1X2\",\"id_outcome\":4273848547,\"unique_id\":\"4459816548;2666973288;4273848547\",\"outcome_alias\":\"2\",\"ext_id\":\"32941765015720230\",\"outcome_name\":\"Away\",\"outcome_odd_value\":\"12.54\",\"outcome_odd_value_original\":\"12.54\",\"outcome_odd_percent\":\"62.79\",\"outcome_odd_percent_original\":\"62.79\",\"outcome_key_value\":7.974481658692185,\"outcome_key_value_original\":7.974481658692185,\"outcome_odd_value_for_order\":12.54,\"active\":true,\"multiplicity\":\"1-30\",\"multiplicity_min\":\"1\",\"multiplicity_max\":\"30\",\"market_fixed\":0,\"spec\":\"\",\"type\":\"prematch\",\"specifier\":\"\",\"event_description\":\"Panama - Guadeloupe\",\"time\":1750114800000,\"event_source\": 4459816548,\"sport\":{\"id\":8412615417,\"_id\":\"60703069a936cb5d3422bb59\",\"source\":8412615417,\"name\":\"Football\",\"order\":1,\"status\":true},\"category\":{\"id\":1402297580,\"_id\":\"6082e765e7ddcf34a099ff0e\",\"source\":1402297580,\"name\":\"International\",\"order\":3,\"status\":true},\"tournament\":{\"id\":8299480767,\"_id\":\"60ddf1567d050b8659761d23\",\"source\":8299480767,\"name\":\"CONCACAF Gold Cup\",\"order\":9999,\"status\":true},\"quickbet\":\"43008\"}],\"type\":\"single\",\"_multiple_detail\":{\"amount\":100,\"bonus\":0,\"bonus_percentage\":0,\"multiplicity\":1,\"odds_total\":12.54,\"profit\":1154,\"winning\":1254,\"winning_total\":1254,\"expectedTaxOnWonAmount\":0,\"expectedTotalTaxedWinnings\":1254,\"expectedProfitTaxed\":1154}}}",
  "lang": "en",
  "accept_odds": true,
  "hash": "U2FsdGVkX19EtRS0QPasdfsdf4YDKCTDFWA1HXFKG8dv4cf6th0DhRwukzSQ7isCCxP",
  "type_user": "user",
  "userInfo": {
    "id": "9999",
    "login": "alonG"
  }
}
{
  "header": {
    "httpStatusCode": 1,
    "errors": [
      {
        "message": "text"
      }
    ]
  },
  "body": {
    "bet_code": "7tnsd4d0d-h1d2r2lfs3",
    "shortCode": "2518",
    "result": true
  }
}

IMPORTANT NOTE:

for more information about bet_to_check property in the POST /cart/place-bet refer to - Place Bet - bet_to_check structure

Get bet details for players

post

Retrieve bet information for player

Authorizations
Body
codestringRequired

Unique bet code identifier

Example: 7tnsd4d0d-h1d2r2lfs3
Responses
200

Bet details retrieved successfully

application/json
post
POST /bet/detail HTTP/1.1
Host: rms-bet-api.lsports.eu
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 31

{
  "code": "7tnsd4d0d-h1d2r2lfs3"
}
{
  "header": {
    "httpStatusCode": 1,
    "errors": [
      {
        "message": "text"
      }
    ]
  },
  "body": {
    "success": true,
    "data": {
      "code": "7tnsd4d0d-h1d2r2lfs3",
      "platform_id": 1001,
      "user_id": 9999,
      "type": "single",
      "bet_context": "prematch",
      "status": "accepted",
      "result": "pending",
      "odds": [
        {
          "id_market": 2666973288,
          "market_unique_id": "2666973288",
          "market_name": "1X2",
          "id_outcome": 4273848547,
          "unique_id": "4459816548;2666973288;4273848547",
          "outcome_alias": "2",
          "ext_id": "32941765015720230",
          "outcome_name": "Away",
          "outcome_odd_value": "12.54",
          "outcome_odd_value_original": "12.54",
          "outcome_odd_percent": "62.79",
          "outcome_odd_percent_original": "62.79",
          "outcome_key_value": 7.974481658692185,
          "outcome_key_value_original": 7.974481658692185,
          "outcome_odd_value_for_order": 12.54,
          "active": true,
          "multiplicity": "1-30",
          "multiplicity_min": "1",
          "multiplicity_max": "30",
          "market_fixed": 0,
          "spec": "",
          "type": "prematch",
          "specifier": "",
          "event_description": "Panama - Guadeloupe",
          "time": 1750114800000,
          "event_source": 4459816548,
          "sport": {
            "id": 8412615417,
            "_id": "60703069a936cb5d3422bb59",
            "source": 8412615417,
            "name": "Football",
            "order": 1,
            "status": true
          },
          "category": {
            "id": 1402297580,
            "_id": "6082e765e7ddcf34a099ff0e",
            "source": 1402297580,
            "name": "International",
            "order": 3,
            "status": true
          },
          "tournament": {
            "id": 8299480767,
            "_id": "60ddf1567d050b8659761d23",
            "source": 8299480767,
            "name": "CONCACAF Gold Cup",
            "order": 9999,
            "status": true
          },
          "quickbet": "43008",
          "status_event": "active"
        }
      ],
      "odds_sources": [
        "4459816548;2666973288;4273848547"
      ],
      "amount_real": 100,
      "currency": "EUR",
      "currencySymbol": "€",
      "created_at": 1735123456789,
      "sent_time": 1735123456789,
      "oddHash": "U2FsdGVkX19EtRS0QPasdfsdf",
      "betCode": "2518",
      "_multiple_detail": {
        "amount": 100,
        "odds_total": 12.54,
        "multiplicity": 1,
        "winning": 1254,
        "bonus_percentage": 0,
        "bonus": 0,
        "winning_total": 1254,
        "profit": 1154,
        "expectedTaxOnWonAmount": 0,
        "expectedTotalTaxedWinnings": 1254,
        "expectedProfitTaxed": 1154
      },
      "_system_detail": {
        "amount_system": 50,
        "fixed_bases": [],
        "combinations": 3,
        "winning_min_taxed": "56.50",
        "winning_max_taxed": "358.77",
        "winning_total_min_taxed": "56.50",
        "winning_total_max_taxed": "358.77",
        "winning_all_taxed": "521.10",
        "winning_all_total_taxed": "521.10",
        "winning_min": "56.50",
        "winning_max": "358.77",
        "winning_total_min": "56.50",
        "winning_total_max": "358.77",
        "bonus_min": "0.00",
        "bonus_max": "0.00",
        "winning_all": "521.10",
        "winning_all_total": "521.10",
        "valid_combinations_all": 3
      },
      "system_parts": [
        {
          "amount": 16.67,
          "checked": true,
          "multiplicity": 1,
          "num_combo": 2,
          "combinationsOdds": [],
          "show": false,
          "context": "prematch",
          "bets": [
            {}
          ]
        }
      ]
    }
  }
}

Settle a bet slip

post

Settle a bet slip with a given code and status. Requires JWT Bearer token authentication.

Authorizations
Body
codestringRequired

Unique bet code identifier

Example: wzc3457n7-h1d2q27q109
statusstring · enumRequired

Status of the bet

Example: winPossible values:
subCodestring | nullableOptional

Unique sub bet code identifier (required for system bet slip)

Example: pnme81n2-h1ch2k2r2i9
multiplicitynumber | nullableOptional

The multiplicity number of markets in the bet slip (required for system bet slip)

Example: 1
Responses
200

Bet successfully updated

application/json
post
POST /bet/define HTTP/1.1
Host: rms-bet-api.lsports.eu
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 47

{
  "code": "wzc3457n7-h1d2q27q109",
  "status": "win"
}
{
  "header": {
    "httpStatusCode": 1,
    "errors": [
      {
        "message": "text"
      }
    ]
  },
  "body": {
    "message": "Bet with code 'wzc3457n7-h1d2q27q109' updated to status 'win'."
  }
}

USERS

Get players by platformId with pagination

get

Retrieves a list of players for a given platformId with pagination. If no players are found, it returns a 200 status with an empty list.

Authorizations
Path parameters
platformIdstringRequired

Platform ID to filter players by

Example: 12345
Query parameters
pageintegerOptional

Page number for pagination

Example: 1
limitintegerOptional

Number of players per page

Example: 10
Responses
200

A list of players, or an empty list if none found

application/json
get
GET /platforms/{platformId} HTTP/1.1
Host: rms-bet-api.lsports.eu
Authorization: Bearer JWT
Accept: */*

{
  "header": {
    "httpStatusCode": 1,
    "errors": [
      {
        "message": "text"
      }
    ]
  },
  "body": {
    "players": [
      {
        "_id": "507f1f77bcf86cd799439011",
        "platformId": "12345",
        "userId": "user123"
      }
    ],
    "total": 100,
    "totalPages": 10,
    "currentPage": 1,
    "pageSize": 10
  }
}
PreviousIntegration GuideNextPlace Bet - bet_to_check structure

Last updated

Was this helpful?