Overview

Place Bet API allow clients to send bets and validate their actuality (check markets/selections statuses, actual prices) to prevent place bets on non actual data and build risk management reports which will protect provider and clients from abusing. 

Glossary

Provider - B1 who provide data feed and place bet api for risk management

Client - Operator 3rd-party system who consume data feed and allow users to place bets on markets

Brand - One of the WL or bands of client

Player - Unique user from client side who place bets on markets

Security

Provider provides credentials (client id and client secret) for client with which client should login by token endpoint and get JWT token for accessing Place Bet API. Token has ttl 1 hour, so every 1 hour client should do new login and refresh JWT token.

JWT token should passed as HTTP Header Authorization

API

Environments

Stage: 

• https://stage-trading-bet-api.betgate.dev 
• https://stage-trading-bet-acceptance-service.betgate.dev

Prod: 

• https://trading-bet-api.betgate.dev
• https://trading-bet-acceptance-service.betgate.dev

Token login

Method: HTTPS POST

URI: /api/v1/token

Credentials should be passed in URL. Example: https://clientId:clientSecret@stage-trading-bet-api.betgate.dev/api/v1/token

Response Example: 

200 - Login is successfull and system created JWT token for client

{
    "token": "Bearer jwtsecuretoken"
}

401/403 - Credentials are wrong

Place bet

Method: HTTP POST

URI: /api/v1/sport/v1/bet

Headers:

Body request:

{
  "items": [
    {
      "eventId": "105600",
      "odds": 1.9,
      "sourceOutcomes": [
        {
          "selection": "[2,[],[0],1,3,[]]",
          "odds": 1.9
        }
      ]
    }
  ],
  "amount": 100,
  "betType": "Ordinar",
  "oddsChangePolicy": "Any",
  "marketChangePolicy": "None",
  "systemSize": 80,
  "transactionId": "432e627b-f8d1-45ef-9ae9-03632956548b"
}

Bet type

Ordinar - a wager on a specific outcome of a single event. The winnings are calculated by multiplying the bet amount by the odds of the outcome.

Express - a wager on multiple independent events. An express bet wins only when all of its component outcomes are successful; if even one outcome is unsuccessful, the express bet is lost. The winnings are calculated by multiplying the bet amount by the odds for all the outcomes included in the express bet."

Responses:

200 - OK, bet is accepted by provider

{
    "betId": "432e627b-f8d1-45ef-9ae9-03632956548b",
    "betOdd": 15,
    "betDate": "2026-02-15T11:15:40.252615Z",
    "possiblePayout": 1500,
    "items": [
        {
            "acceptedOdd": 15,
            "sourceOutcomeSelectionKeys": [
                "[2,[],[0],1,0,[]]"
            ]
        }
    ],
    "specialBetTypes": []
}

400 - Bad Request

{
    "message": "Bet odds were changed. ",
    "errors": {
        "common": {
            "actualOdds": 15.00,
            "betOdds": 20
        }
    }
}

{
    "message": "Selection is not found. ",
    "errors": {
        "common": {}
    }
}

403/401 - Access denied

Express Bets

POST /api/v1/sport/v1/bet · betType: "Express". 

Headers are the same as for Ordinar.

Request

An Express carries one stake over 2 to 20 legs, one leg per event. eventId must be unique across items, and each item holds exactly one selection.

{
 "items": [
   {
     "eventId": "105600",
     "odds": 1.9,
     "sourceOutcomes": [
       { "selection": "[2,[],[0],1,3,[]]", "odds": 1.9 }
     ]
   },
   {
     "eventId": "105601",
     "odds": 2.1,
     "sourceOutcomes": [
       { "selection": "[2,[],[0],1,1,[]]", "odds": 2.1 }
     ]
   },
   {
     "eventId": "105602",
     "odds": 1.5,
     "sourceOutcomes": [
       { "selection": "[5,[2.5],[0],1,4,[]]", "odds": 1.5 }
     ]
   }
 ],
 "amount": 100,
 "betType": "Express",
 "oddsChangePolicy": "AcceptBetterOdds",
 "marketChangePolicy": "None",
 "systemSize": 100,
 "transactionId": "432e627b-f8d1-45ef-9ae9-03632956548b"
}

Response 200

betOdd is the exact product of the accepted leg prices and possiblePayout is exactly amount * betOdd. Neither is rounded, so three prices with two decimals can return up to six decimals.

{
 "betId": "432e627b-f8d1-45ef-9ae9-03632956548b",
 "betOdd": 5.985,
 "betDate": "2026-09-29T08:43:58.488Z",
 "possiblePayout": 598.5,
 "items": [
   { "acceptedOdd": 1.9, "sourceOutcomeSelectionKeys": ["[2,[],[0],1,3,[]]"] },
   { "acceptedOdd": 2.1, "sourceOutcomeSelectionKeys": ["[2,[],[0],1,1,[]]"] },
   { "acceptedOdd": 1.5, "sourceOutcomeSelectionKeys": ["[5,[2.5],[0],1,4,[]]"] }
 ],
 "specialBetTypes": []
}

Responce 400

Messages new to Express. Every message value ends with a trailing space.

{
 "message": "Express bet requires at least 2 items. ",
 "errors": {
   "common": {
     "expectedBetItemsCount": 2,
     "actualBetItemsCount": 1
   }
 }
}

The Ordinar messages are unchanged and also apply: Selection is not found., Market is SUSPENDED., Selection is SUSPENDED., Bet odds were changed.. On an Express they describe the first leg that failed, not the whole betslip, and validation stops there.