Create a new bet

POST /notification/create/

Operation ID: create_new_notification

Create a new notification. This API is supposed to be used by punters who want to automate triggering notifications. For example, punters can connect to their favourite tipster that is not listed as our partner tipsters.

Request Body

The request body should contain a NotificationCreateQ object with the following parameters:

Required Parameters

Field
Type
Required
Description

type

string

Yes

Notification type. Either "Fixed Win" or "Fixed Profit"

sports

string

Yes

Sports type. E.g, RACING, AFL, NBA

Racing Parameters

Field
Type
Required
Description

competition

string

No

Competition name i.e., venue name. Supposed to be one of the ones returned by /competition/namecodes/ API call

code

string

No

Event code. One of ["Galloping", "Harness", "Greyhounds"]

event_number

integer

No

Event no i.e., race no

market

string

No

Target bet market. Supposed to be a full name of the market returned by /bet/markets/

selection

string

No

Target runner. For markets other than Same Race Multi, it is a string of one number. For Same Race Multi market, it is a string of "R:P" separated by comma where R is for runner no and P is for Top place index. E.g. "1:2,3:3" means Runner 1 for Top 2 and Runner 3 for Top 3

start_time

string

No

Date and Time with Timezone offset in ISO 8601 standard format for datetime (YYYY-MM-DDTHH:mm:ss+HH:MM) i.e 2024-10-28T13:53:00+10:00. It is optional, if not provided the system will pick up the next event

Sports Parameters

Field
Type
Required
Description

sports_market

integer

No

Market objects's foreign key

sports_selection

integer

No

Selection objects's foreign key

event_id

integer

No

Event objects's foreign key

handicap

integer

No

Line number for selection

Betting Amounts

Field
Type
Required
Description

stake

number

No

Wager amount in dollars for Fixed Win type notification. Bot will wager this amount on all running sessions

target_profit

number

No

Wager amount in dollars for Fixed Profit type notification. Bot will check the current odds and calculate the wager amount automatically so that the profit is equal (or a little less because of rounding) to this value

total_wager

number

No

Total wager amount in dollars for High Odds First type notification. Bot will check the current odds and try to wager as much as possible from the bookie with the highest price. The process continues until the total amount is wagered

Odds Management

Field
Type
Required
Description

odds

number

No

Minimum odds. This is optional and it will be only used when you set check_odds to true

check_odds

boolean

No

Check minimum odds. If this value is true, the bot will compare the current odds with the odds specified above and only place bets if the current odds is not less than the minimum odds specified in the notification

check_max_odds

boolean

No

Check maximum odds. If this value is true, the bot will compare the current odds with the odds specified above and only place bets if the current odds is less than the maximum odds specified in the notification

max_odds

number

No

Maximum odds

boost_if_available

boolean

No

Boost odds if available

spg_if_available

boolean

No

Use SPG if available

Account Targeting

Field
Type
Required
Description

choose_best_odds

integer

No

Number of sessions to choose from the running sessions with the best prices. If this value is zero, bet is placed on all running sessions

choose_random_accounts

integer

No

Number of sessions to choose randomly from the running sessions. If this value is zero, bet is placed on all running sessions

choose_random_bots

integer

No

Number of bots to choose randomly from the running sessions. If this value is zero, bet is placed on all running bots

bookies

string

No

Target bookie IDs or names separated by '&'. Leave this value empty if you do not have specific target bookies

target_session

string

No

Target bot session IDs or names separated by '&'. Leave this value empty if you do not have specific target session

target_bot

string

No

Target bot IDs or names separated by '&&##&&'. Leave this value empty if you do not have specific target bot

Betting Options

Field
Type
Required
Description

use_bonus

boolean

No

Specify if this notification is for bonus bet (bet using bonus money)

bonus_back_if_available

boolean

No

Default value is True

ensure_total_wager

boolean

No

Specify the total amount rather than stake per bookie. The bot will divide the total amount by the number of running bookies to calculate the final bet amount

allow_double_bets

boolean

No

If a bot fails on a bookie, it will try to repeat the bet on other successful bookies to ensure the total wager

one_account_per_bookie

boolean

No

Default value is False

Timing and Scheduling

Field
Type
Required
Description

delay

boolean

No

Specify if the bot needs to delay before handling this notification

is_scheduled

boolean

No

True if this is a scheduled notification

is_market_open

boolean

No

True if this is a market open notification

auto_trigger

boolean

No

If true, trigger this scheduled notification automatically at specific time, by default only triggered manually by user

scheduled_at

integer

No

Express the scheduled notification trigger time in seconds before the start time of the race. By default 1 min. 5 secs accuracy

Group Bot Features

Field
Type
Required
Description

enable_group_bot

boolean

No

Default value is False

enable_group_bot_delay

integer

No

Default value is 10

Advanced Options

Field
Type
Required
Description

source_type

string

No

Source

bot_delay_min_time

integer

No

Default value is 0

bot_delay_max_time

integer

No

Default value is 0

choose_random_bot_delay_mode

string

No

Choose Random Bot Delay Mode (totalised, sequential)

session_delay

array

No

Array of Delay objects

bot_delay

array

No

Array of Delay objects

label

string

No

Label

Delay Object

Field
Type
Required
Description

delay

integer

Yes

Delay in seconds

is_random

boolean

Yes

Generate a random flag. If true, select a random time between 0 seconds and the delay period

identifier

string

Yes

identifier

Usage Examples

Choose Best Odds (5 Bookies)

What it does: This automatically selects and places bets on the 5 bookmaker accounts that currently offer the best (highest) odds for your selection, maximizing your potential returns. The stake amount ($10) will be placed on EACH of the 5 selected bookmaker sessions.

{
  "type": "Fixed Wager",
  "competition": "BELMONT",
  "code": "Galloping",
  "event_number": 6,
  "market": "Fixed Win",
  "selection": "3",
  "stake": 10,
  "choose_best_odds": 5,
  "sports": "RACING"
}

Bet on All Bookies Above Minimum Odds

What it does: This places bets on all available bookmaker accounts, but only if the current odds are above your specified minimum threshold of $3.00. This ensures you only bet when the odds provide sufficient value. The stake amount ($20) will be placed on EACH bookmaker session that meets the minimum odds criteria.

{
  "type": "Fixed Wager",
  "competition": "FLEMINGTON",
  "code": "Galloping",
  "event_number": 8,
  "market": "Fixed Win",
  "selection": "5",
  "stake": 20,
  "check_odds": true,
  "odds": 3.0,
  "sports": "RACING"
}

Ensure Total Wager Across All Sessions

What it does: This places a total wager amount of $100 across all selected bookmaker sessions. Unlike the previous examples where the stake is placed on each session, this will divide the total amount equally across all qualifying sessions. For example, if 5 sessions qualify, each will receive $20 ($100 ÷ 5 sessions).

{
  "type": "Fixed Wager",
  "competition": "RANDWICK",
  "code": "Galloping",
  "event_number": 3,
  "market": "Fixed Win",
  "selection": "7",
  "stake": 100,
  "ensure_total_wager": true,
  "check_odds": true,
  "odds": 2.0,
  "sports": "RACING"
}

Same Race Multi Bet

What it does: This places a Same Race Multi bet where you select multiple runners for different finishing positions in the same race. In this example, Runner 1 is selected for Top 2 finish and Runner 5 is selected for Top 3 finish. The stake amount ($15) will be placed on EACH bookmaker session.

{
  "type": "Fixed Wager",
  "competition": "CAULFIELD",
  "code": "Galloping",
  "event_number": 5,
  "market": "Same Race Multi",
  "selection": "1:2,5:3",
  "stake": 15,
  "check_odds": true,
  "odds": 4.0,
  "sports": "RACING"
}

Scheduled Bet - 120 Seconds Before Race Jump

What it does: This schedules a bet to be placed automatically 120 seconds (2 minutes) before the race starts. The bet will be queued and executed at the specified time without manual intervention. The stake amount ($25) will be placed on EACH bookmaker session when the scheduled time is reached.

{
  "type": "Fixed Wager",
  "competition": "MOONEE VALLEY",
  "code": "Galloping",
  "event_number": 7,
  "market": "Fixed Win",
  "selection": "4",
  "stake": 25,
  "is_scheduled": true,
  "auto_trigger": true,
  "scheduled_at": 120,
  "sports": "RACING"
}

Scheduled Bet - Manual Trigger Required

What it does: This creates a scheduled bet that will appear in your Betmatic dashboard and wait for you to manually press the 'Trigger' button when you want the bet to be placed. The purpose of using the API in this case is so you don't need to manually enter all your bet details into the dashboard - you can pre-configure multiple bets via API and then trigger them at your chosen moment from the dashboard interface.

{
  "type": "Fixed Wager",
  "competition": "FLEMINGTON",
  "code": "Galloping",
  "event_number": 9,
  "market": "Fixed Win",
  "selection": "2",
  "stake": 30,
  "is_scheduled": true,
  "check_odds": true,
  "odds": 2.5,
  "sports": "RACING"
}

Racing Bet with Session Delay

This example demonstrates how to set exact delays for multiple specific sessions. The session_delay array defines precise timing for each session, with is_random set to false to ensure consistent execution timing.

{
  "type": "Fixed Wager",
  "competition": "BELMONT",
  "code": "Galloping",
  "event_number": 6,
  "market": "Fixed Win",
  "selection": "3",
  "stake": 10,
  "target_session": "session_nickname&session_two",
  "session_delay": [
    {
      "delay": 5,
      "is_random": false,
      "identifier": "session_nickname"
    },
    {
      "delay": 3,
      "is_random": false,
      "identifier": "session_two"
    }
  ],
  "sports": "RACING",
  "label": "Strategy A"
}

Response

Success Response (200)

OK

Error Responses

  • 200 - OK

  • 401 - Invalid credentials

  • 402 - Subscription is not active

  • 404 - Competition or market is unavailable

  • 500 - Internal error

Authentication

This endpoint requires authentication. Include your token in the Authorization header:

Authorization: Token your_token_here

Last updated