Placing Bets Async

Placing multi bets on one ticket is a multi stage process

1. Get the product information
2. Send a request to place a bet against the product
3. Listen to web socket for the acceptance of the bet

Authorization header

Remember to include the Authorization header in the request.

Get product information

RequestResponse

query GetProducts {
  products {
    nodes {
      id
      name
      type {
        ... on BettingProduct {
          betType {
            id,
            code
          },
          selling {
            status
          },
          legs {
            nodes {
              id
              selections {
                nodes {
                id
                name
                }
              }
            }
          }
        }
      }
    }
  }
}

Response

{
  "data": {
    "products": {
      "nodes": [
        {
          "id": "97f60c59-5540-4fd4-8863-52b80c0d9e89",
          "name": "BATH 13:40 - Win",
          "betType": {
            "id": "1",
            "code": "WIN"
          },
          "selling": {
            "status": "OPEN"
          },
          "legs": {
            "nodes": [
              {
                "id": "5ff0aae6-29a1-4f6a-98c0-190b06aa1300",
                "selections": {
                  "nodes": [
                    {
                      "id": "aeac6957-4fec-4fc9-95c4-683bd25eec5b",
                      "name": "Ala Kaifi"
                    },
                    {
                      "id": "1cf6df9e-baa5-4f25-bf02-ac2ee4c66e7c",
                      "name": "Al Tarfa"
                    },
                    {
                      "id": "c7a329b5-2fbc-4ff2-b826-084a13b939d9",
                      "name": "Ajyad"
                    },
                    {
                      "id": "51f45b63-55ea-4550-bdcf-bfa7827dc1c2",
                      "name": "Miss Dolly Rocker"
                    },
                    {
                      "id": "0d35f4ab-e618-44bf-9d80-d6d40ab3e540",
                      "name": "The Famous Mrs B"
                    }
                  ]
                }
              }
            ]
          }
        }
      ]
    }
  }
}

Placing the bet

NOTE:

A full list of supported bet types with examples is available here.

IMPORTANT:

The ticketId supplied on each request must be unique. This is used for idempotency checks to ensure that the customers account is only debited once if the request is sent multiple times, which could happen due to network issues. In such an event, no bet will be placed as a result of the duplicate request, but the response will be the same as the original request with the exception of the Idempotent field; which can be used to identify that the request was considered a duplicate.

Similarly, each betId should be unique for the customer, if a ticket contains a betId that is not unique for the customer; the entire ticket will be rejected.

From the response above, we can see the ProductId is 97f60c59-5540-4fd4-8863-52b80c0d9e89 and that it is a Win product. There is one leg, with an Id of 5ff0aae6-29a1-4f6a-98c0-190b06aa1300, and there are 5 selections to pick from.

If we wanted to place a £1.50 bet on "Miss Dolly Rocker", which has the Id 51f45b63-55ea-4550-bdcf-bfa7827dc1c2 and £2.00 on "The Famous Mrs B", which has the Id "0d35f4ab-e618-44bf-9d80-d6d40ab3e540". We would send the following request.

RequestResponse

Async Request: Bet on Miss Dolly Rocker to Win and The Famous Mrs B to Win

mutation PlaceBetsAsync {
  placeBetsAsync(
    input: {
      ticketId: "ticket-42acb0ae-5e1c-4d48-b412-644c9c4a56a0"
      bets: [
        {
          betId: "bet-win-42acb0ae-5e1c-4d48-b412-644c9c4a56a0"
          productId: "97f60c59-5540-4fd4-8863-52b80c0d9e89"
          stake: { currencyCode: GBP, totalAmount: 1.50 }
          legs: [
            {
              productLegId: "5ff0aae6-29a1-4f6a-98c0-190b06aa1300"
              selections: [{ productLegSelectionID: "51f45b63-55ea-4550-bdcf-bfa7827dc1c2" }]
            }
          ]
        },
        {
          betId: "bet-win-44af934d-6823-4fd7-9a39-11edd4be3ccf"
          productId: "97f60c59-5540-4fd4-8863-52b80c0d9e89"
          stake: { currencyCode: GBP, totalAmount: 2.00 }
          legs: [
            {
              productLegId: "5ff0aae6-29a1-4f6a-98c0-190b06aa1300"
              selections: [{ productLegSelectionID: "0d35f4ab-e618-44bf-9d80-d6d40ab3e540" }]
            }
          ]
        }
      ]
    }
  ) {
    ticket {
      id
      toteId
      bets {
        nodes {
          id
          toteId
          placement {
            status
          }
        }
      }
      idempotent
    }
  }
}

{
  "data": {
    "placeBets": {
      "ticket": {
        "id": "ticket-42acb0ae-5e1c-4d48-b412-644c9c4a56a0",
        "toteId": "6ff21d98-1e0c-453f-8b66-3cd301d3e529",
        "bets": {
          "nodes": [
            {
              "id": "bet-win-42acb0ae-5e1c-4d48-b412-644c9c4a56a0",
              "toteId": "8779011e10f4462988f6b9b5364e9a00",
              "placement": {
                "status": "PLACED"
              }
            },
            {
              "id": "bet-win-44af934d-6823-4fd7-9a39-11edd4be3ccf",
              "toteId": "dde8b00ed0c340a9b445f00f705299be",
              "placement": {
                "status": "PLACED"
              }
            }
          ]
        },
        "idempotent": false
      }
    }
  }
}

Acceptance of the bet

After a bets is sent to the API, it can be either Accepted, Rejected or Fail to be placed due to a system error. For each bet there is be individual request to the web socket message.

BetAccepted

{
  "MessageType": "BetAccepted",
  "BetId": "f8dd4ab924fa4ab19acf8f37f176f3d0",
  "CustomerBetId": "bet-win-42acb0ae-5e1c-4d48-b412-644c9c4a56a0",
  "CreatedAt": "2024-07-10T14:17:16.251Z"
}

BetRejected

{
  "MessageType": "BetRejected",
  "BetId": "2c14a75b0f8c483197cbdf37910ccd03",
  "CustomerBetId": "bet-win-42acb0ae-5e1c-4d48-b412-644c9c4a56a0",
  "CreatedAt": "2024-07-10T14:17:16.251Z"
}

BetFailed

{
  "MessageType": "BetFailed",
  "BetId": "af0fc513a53d4cc7acc3e00416abf056",
  "CustomerBetId": "bet-win-42acb0ae-5e1c-4d48-b412-644c9c4a56a0",
  "CreatedAt": "2024-07-10T14:17:16.251Z"
}