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
type
string
Yes
Notification type. Either "Fixed Win" or "Fixed Profit"
sports
string
Yes
Sports type. E.g, RACING, AFL, NBA
Racing Parameters
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
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
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
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
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
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
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
enable_group_bot
boolean
No
Default value is False
enable_group_bot_delay
integer
No
Default value is 10
Advanced Options
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
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.
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.
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).
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.
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.
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.
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.
Response
Success Response (200)
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:
Last updated