Bets API

Risk management endpoins

Bets API endpoints are used as a part of risk management service.

The most important endpoints are below.

Bet Placement Endpoint

Can be used to send bets to Odds88.

The bet will be validated according to related event(s), market(s), selection(s) statuses, odds and liabilities.

The response will contain a recommendation whether to accept or reject the bet.

The endpoint should be called after the funds has been reserved on the player's account.

If the response it "accepted", the bet will be saved in Odds88 system.

This endpoint has a LTD (Live Time Delay) implemented for events which are Live. The bets will only be accepted after a predetermined period, depending on the event’s level and network latency.

playerId must be consistent for the same player regardless of the currency that is used.

Places bet from specific player (multi-currency).

put

Authorizations

Bearer

HTTPRequired

JWT Authorization header using the Bearer scheme. Example: "Authorization: Bearer {token}"

Path parameters

playerIdstringRequired

Id of player which places a bet.

Body

application/jsontext/jsonapplication/*+json

Represents bet request.

idstring · nullableOptional

Unique request id (in the client's system);

priceChangeinteger · enumOptional

Types of price change acceptance.

• 0 - None
• 1 - Any
• 2 - Higher

Possible values:

alternativeOddsIdstring · nullableOptional

ID of alternative odds offer in case if liability was exceeded

alternativePricenumber · double · nullableOptional

Alternative odds offer value

customPayoutMultipliernumber · double · nullableOptional

Custom payout multiplier

betTypeinteger · int32Optional

Bet Type. (Standard - 0, Pickem - 1)

freeBetTypeinteger · int32Optional

Free Bet Type. (NotFree = 0, BasicFreeBet = 1)

Responses

200

Returns results of bet placement request.

text/plainapplication/jsontext/json

responseCodeinteger · enumOptional

• 1 - Success
• 2 - FormatError
• 3 - PrecisionMismatch
• 4 - UnsupportedCurrency

Possible values:

errorMessagestring · nullableOptional

400

Request arguments are not valid.

text/plainapplication/jsontext/json

401

Unauthorized

403

Forbidden

500

Unexpected error occurred.

put

/api/players/{playerId}/Bets/V2

HTTPcURLJavaScriptPython

PUT /api/players/{playerId}/Bets/V2 HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 402

{
  "id": "text",
  "player": {
    "deviceId": "text",
    "languageId": "text",
    "ip": "text",
    "segmentId": 1
  },
  "priceChange": 0,
  "items": [
    {
      "eventId": 1,
      "marketId": 1,
      "selectionId": 1,
      "racingSelection": "text",
      "price": 1,
      "betBuilderBetItems": [
        {
          "marketId": 1,
          "selectionId": 1
        }
      ]
    }
  ],
  "alternativeOddsId": "text",
  "alternativePrice": 1,
  "customPayoutMultiplier": 1,
  "betType": 1,
  "freeBetType": 1,
  "amount": {
    "currency": "text",
    "value": 1,
    "precision": 1
  }
}

application/jsontext/jsonapplication/*+json

{
  "payload": {
    "requestId": "text",
    "resultType": 1,
    "createdAt": "2026-05-14T03:39:21.818Z",
    "cancellationStatus": {
      "status": 1,
      "message": "text"
    },
    "betProcessor": 1,
    "rejectInfo": {
      "reason": 0,
      "betItem": {
        "eventId": 1,
        "marketId": 1,
        "selectionId": 1,
        "racingSelection": "text",
        "price": 1,
        "betBuilderBetItems": [
          {
            "marketId": 1,
            "selectionId": 1
          }
        ]
      },
      "message": "text",
      "alternativeOdds": {
        "id": "text",
        "alternativePrice": 1,
        "createdAt": "2026-05-14T03:39:21.818Z",
        "expiredAt": "2026-05-14T03:39:21.818Z"
      },
      "maxBet": {
        "currency": "text",
        "value": 1,
        "precision": 1,
        "exchangeRate": 1
      }
    },
    "acceptedBet": {
      "id": "text",
      "player": {
        "deviceId": "text",
        "languageId": "text",
        "ip": "text",
        "segmentId": 1
      },
      "kind": 1,
      "priceChange": 1,
      "alternativePrice": 1,
      "originalBetId": "text",
      "customPayoutMultiplier": 1,
      "betType": 0,
      "freeBetType": 0,
      "items": [
        {
          "eventId": 1,
          "marketId": 1,
          "selectionId": 1,
          "racingSelection": "text",
          "price": 1,
          "alternativePrice": 1,
          "betBuilderBetItems": [
            {
              "marketId": 1,
              "selectionId": 1
            }
          ]
        }
      ],
      "amount": {
        "currency": "text",
        "value": 1,
        "precision": 1,
        "exchangeRate": 1
      }
    }
  },
  "responseCode": 1,
  "errorMessage": "text"
}

Max Bet Endpoint

Can be used to get the max possible value for a particular bet for a particular player.

The bet will be validated according to related event(s), market(s), selection(s) statuses, odds and liabilities.

The bet will not be saved in Odds88 system, so this endpoint can be called before locking funds on the player's account.

Gets max possible bet size for the specific player (multi-currency).

post

Authorizations

Bearer

HTTPRequired

JWT Authorization header using the Bearer scheme. Example: "Authorization: Bearer {token}"

Path parameters

playerIdstringRequired

Id of player which places a bet.

Body

application/jsontext/jsonapplication/*+json

Represents bet request.

idstring · nullableOptional

Unique request id (in the client's system);

priceChangeinteger · enumOptional

Types of price change acceptance.

• 0 - None
• 1 - Any
• 2 - Higher

Possible values:

alternativeOddsIdstring · nullableOptional

ID of alternative odds offer in case if liability was exceeded

alternativePricenumber · double · nullableOptional

Alternative odds offer value

customPayoutMultipliernumber · double · nullableOptional

Custom payout multiplier

betTypeinteger · int32Optional

Bet Type. (Standard - 0, Pickem - 1)

freeBetTypeinteger · int32Optional

Free Bet Type. (NotFree = 0, BasicFreeBet = 1)

Responses

200

Returns results of max bet calculation.

text/plainapplication/jsontext/json

rejectReasoninteger · int32Optional

Information about rejection cause. (None - 0, UnknownError - 1, PriceChanged - 2, LimitExceeded - 3 , SelectionNotFound - 4 etc.)

amountinteger · int64Optional

Max bet amount in local currency

400

Request arguments are not valid.

text/plainapplication/jsontext/json

401

Unauthorized

403

Forbidden

500

Unexpected error occurred.

post

/api/players/{playerId}/Bets/V2/max

HTTPcURLJavaScriptPython

POST /api/players/{playerId}/Bets/V2/max HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 402

{
  "id": "text",
  "player": {
    "deviceId": "text",
    "languageId": "text",
    "ip": "text",
    "segmentId": 1
  },
  "priceChange": 0,
  "items": [
    {
      "eventId": 1,
      "marketId": 1,
      "selectionId": 1,
      "racingSelection": "text",
      "price": 1,
      "betBuilderBetItems": [
        {
          "marketId": 1,
          "selectionId": 1
        }
      ]
    }
  ],
  "alternativeOddsId": "text",
  "alternativePrice": 1,
  "customPayoutMultiplier": 1,
  "betType": 1,
  "freeBetType": 1,
  "amount": {
    "currency": "text",
    "value": 1,
    "precision": 1
  }
}

application/jsontext/jsonapplication/*+json

{
  "rejectReason": 1,
  "amount": 1
}

Bet Builder Price Endpoint

Allows to get bet builder odds for the provided combination.

The endpoint will respond with potential odds or rejection information.

Gets bet builder price.

post

Authorizations

Bearer

HTTPRequired

JWT Authorization header using the Bearer scheme. Example: "Authorization: Bearer {token}"

Path parameters

playerIdstringRequired

Id of player which placed a bet.

Body

application/jsontext/jsonapplication/*+json

Represents BetBuilder price request.

requestIdstring · min: 1Required

Id of the requests.

segmentIdinteger · int32 · min: 1 · max: 9223372036854776000Required

Segment of the price requesting player.

eventIdinteger · int64 · min: 1 · max: 9223372036854776000Required

Event id price is requested for.

Responses

200

Returns price for potential betbuilder bet.

text/plainapplication/jsontext/json

Represents response to a BetBuilder price request.

requestIdstring · nullableOptional

Id of the price request.

pricenumber · double · nullableOptional

Suggested price for the BetBuilder request.

timeStampstring · date-timeOptional

Time stamp of the request.

400

Request arguments are not valid.

text/plainapplication/jsontext/json

401

Unauthorized

403

Forbidden

500

Unexpected error occurred.

post

/api/players/{playerId}/Bets/bet-builder-price

HTTPcURLJavaScriptPython

POST /api/players/{playerId}/Bets/bet-builder-price HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 86

{
  "requestId": "text",
  "segmentId": 1,
  "eventId": 1,
  "bets": [
    {
      "marketId": 1,
      "selectionId": 1
    }
  ]
}

application/jsontext/jsonapplication/*+json

{
  "requestId": "text",
  "price": 1,
  "timeStamp": "2026-05-14T03:39:21.818Z",
  "rejectInfo": {
    "reason": 0,
    "betItem": {
      "eventId": 1,
      "marketId": 1,
      "selectionId": 1,
      "racingSelection": "text",
      "price": 1,
      "betBuilderBetItems": [
        {
          "marketId": 1,
          "selectionId": 1
        }
      ]
    },
    "message": "text",
    "alternativeOdds": {
      "id": "text",
      "alternativePrice": 1,
      "createdAt": "2026-05-14T03:39:21.818Z",
      "expiredAt": "2026-05-14T03:39:21.818Z"
    },
    "maxBet": 1
  }
}