Odd Format

We’re using following convention for odds format:

Action status and message

We have following table for all the possible actionStatus and actionMessage:

API authentication

As we provide our API to authorized users only, you will need to provide your credentials for all API calls. To do this, there are 2 required parameters to be attached in each API call:

• username: The username assigned to you. Example: unity_groupXX, unity_groupYY…
• accessToken: A hash string, generated from username, password and current time. Please follow this procedure to get your access token:
  • Get the current date and time of the system. Convert it into GMT+0.
  • Concatenate the username, password, and the date and time in the following format: username_dd/MM/yyyy_password_HH/mm
    • username: is the above mentioned username
    • dd/MM/yyyy: the current universal date. Example: 10/09/2012
    • password: the password given to you separately
    • HH/mm: the current universal time. Example: 11/59
  • Make a MD5 hash of the above string. The output value is the required access token.

Following is the Java code to generate this access token:

    public static String getAccessToken(String username, String password) {
        StringBuilder builder;
        DateFormat dateFormat;
        Date time = new Date();
        
        // combine the input fields
        builder = new StringBuilder();
        builder.append(username).append('_');

        dateFormat = new SimpleDateFormat("dd/MM/yyyy");
        dateFormat.setTimeZone(TimeZone.getTimeZone("GMT-0:00"));
        String date1 = dateFormat.format(time);
        builder.append(date1).append('_');

        builder.append(password).append('_');

        dateFormat = new SimpleDateFormat("HH/mm");
        dateFormat.setTimeZone(TimeZone.getTimeZone("GMT-0:00"));
        String date2 = dateFormat.format(time);
        builder.append(date2);

        try {
            byte[] bytesOfMessage = builder.toString().getBytes("utf-8");
            MessageDigest md = MessageDigest.getInstance("MD5");
            byte[] theDigest = md.digest(bytesOfMessage);

            String result = new String(Hex.encodeHex(theDigest));
            return result;
        } catch (Exception e) {
            return null;
        }
    }

Bet status

We use following status code for the bets:

Tracking and report issues

Even though this section is optional, we highly recommend you to enable this tracking so it’s easier to debug any issues happen while you’re calling to our service. To enable this, for each API call, you just need to provide an extra parameter reqId. There is no requirement for this parameter, you can use any convention that suit you the best. However, please make sure that this reqId is unique for all your calls. Following is a sample Java code to generate this value:

    public static String generateReqId() {
        return UUID.randomUUID().toString();
    }

To report any problem, you can give us the reqId of the corresponding calls. It’ll be much faster for us to track down the issues from our logs.

Bet Validation

Before placing a bet, the system validates the input, PlaceBetForm, with bet slip from the sportbook, so it has to satisfy certain conditions:

1. Pivot has no change
2. Bias has no change
3. Score or RedCard has no change (applicable ONLY to LIVE SOCCER)
   • If there is an homeScore / awayScore input and the sportbook provide scores on bet slip , it must be same as ones on bet slip.
   • If there is no homeScore / awayScore input and the sportbook provide scores on bet slip, it compares the current system scores with bet slip scores.
   • If there is an homeScore / awayScore input and the sportbook does not provide scores in the bet slip, the system expects the input same as current system scores.
   • If there is no homeScore / awayScore input and the sportbook does not provide scores in the bet slip, it considers pivot and bias has to be no change.
4. Target Type has no change
5. Target Odds
   • If turning acceptBetterOdd OFF, it must no change.
   • If turning acceptBetterOdd ON, current odds must be equal or greater than target odds.