Create a new notification

The API allows punters to create a new notification, enabling them to automate the process of triggering notifications. This feature is especially useful for punters who want to connect with their preferred tipsters, even if those tipsters are not listed as official partners with BETMATIC.

Endpoint

POST /notification/create/

CURL example


curl -X POST https://betmatic.app/api/notification/create/ \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Token {token}'

Parameters

Name

Type

Required

Description

data

body

NotificationCreateQ

true

Notification data

NotificationCreateQ

Name

Type

Required

Description

type

string

true

Notification type. It can be either "Fixed Win" or "Fixed Profit".

competition

string

true

Competition name, such as the venue name. It should be one of the names returned by the "/competition/namecodes/" API call.

code

string

true

Event code. It should be one of the following options: "Galloping", "Harness", or "Greyhounds".

event_number

integer

true

Event number, typically representing the race number.

market

string

true

Target bet market. It should be the full name of the market returned by the "/bet/markets/" API.

selection

string

true

Target runner. For markets other than Same Race Multi, it should be a single runner number. For Same Race Multi market, it should be a string with "R:P" separated by commas, where R represents the runner number and P represents the top place index. For example, "1:2,3:3" means Runner 1 for Top 2 and Runner 3 for Top 3.

start_time

string

false

Purpose: Target a race meet that is not the next race meet at the specified track Format: ISO 8601 standard (YYYY-MM-DDTHH:mm

+HH:mm)

Default: targets the next upcoming meet at specified competition

stake

number

false

Wager amount in dollars for Fixed Wager type notifications. The bot will wager this amount on all running sessions.

target_profit

number

false

Wager amount in dollars for Fixed Profit type notifications. The bot will calculate the wager amount automatically based on the current odds, ensuring that the profit is equal to (or slightly less due to rounding) this value.

total_wager

number

false

Total wager amount in dollars for High Odds First type notifications. The bot will attempt to wager as much as possible from the bookie with the highest price. The process continues until the total amount is wagered.

odds

number

false

Minimum odds. This parameter is optional and is only used when "check_odds" is set to true.

check_max_odds

boolean

false

Specify whether to check the maximum odds. the bot will compare the current odds with the specified maximum odds and only place bets if the current odds is less than the maximum odds specified in the notification.

max_odds

number

false

Maximum odds. This parameter is optional and is only used when "check_max_odds" is set to true.

check_odds

boolean

false

Specify whether to check the minimum odds. If set to true, the bot will compare the current odds with the specified minimum odds in the notification and place bets only if the current odds are not lower.

boost_if_available

boolean

false

Boost odds if available

spg_if_available

boolean

false

Use SPG if available

ensure_total_wager

boolean

false

Specify the total amount rather than the 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

false

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

choose_best_odds

integer

false

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

choose_random_accounts

integer

false

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

use_bonus

boolean

false

Specify whether this notification is for a bonus bet (bet using bonus money).

bookies

string

false

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

target_session

string

false

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

delay

integer

false

Specify whether the bot needs to delay before handling this notification.

is_scheduled

boolean

false

Set to true if this is a scheduled notification.

auto_trigger

boolean

false

If set to true, this scheduled notification will be triggered automatically at a specific time. By default, it is only triggered manually by the user.

scheduled_at

integer

false

Specify the scheduled notification trigger time in seconds before the start time of the race. The default value is 1 minute with 5 seconds accuracy.

sports

string

true

Sports type, such as RACING, AFL, NBA.

sports_market

integer

false

Foreign key for the Market object.

sports_selection

integer

false

Foreign key for the Selection object.

event_id

integer

false

Foreign key for the Event object.

target_bot

string

false

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

bonus_back_if_available

boolean

false

By enabling this feature, your bot will automatically check for bonus back promotions on betting platforms like Sportsbet or Unibet

Body parameter example for Racing

{
    "type": "Fixed Wager",        // wager the same amount for all sessions
    "competition": "ALBION PARK",
    "code": "Greyhounds",
    "event_number": 1,
    "market": "Fixed Win",
    "selection": "2",              // runner no 2
    "start_time": "2024-10-29T14:08:00+11:00", // targets a specific race meet
    "stake": 100,                  // wager $100 for each bookie
    "target_profit": 100,          // not used for fixed wager type notification
    "total_wager": 500,            // not used for fixed wager type notification
    "odds": 2.5,                   // minimum odds
    "check_odds": true,            // check odds and only place bets if the current odds is over than 2.5
    "boost_if_available": true,    // try boost if available
    "spg_if_available": true,      // try SPG if available
    "ensure_total_wager": true,    // try failed bets on successful bookies again
    "allow_double_bets": true,
    "choose_best_odds": 4,    // pick 4 bookies with the best price and place bets on them
    "choose_random_accounts": 0,
    "use_bonus": false,
    "bookies": "",                  // no specific target bookies
    "is_scheduled": false,
    "auto_trigger": false,
    "scheduled_at": 60,
    "sports": "RACING"
}

Body parameter example for Sports

{
    "type": "Fixed Wager",
    "competition": "",
    "stake": 10,
    "target_profit": 100,
    "total_wager": 500,
    "odds": 2,
    "check_odds": false,
    "boost_if_available": false,
    "ensure_total_wager": false,
    "allow_double_bets": false,
    "choose_best_odds": 0,
    "choose_random_accounts": 0,
    "use_bonus": false,
    "bookies": "",
    "is_scheduled": false,
    "auto_trigger": false,
    "scheduled_at": 60,
    "sports": "AFL",
    "sports_market": 50784,
    "sports_selection": 434974,
    "event_id": 13322
}

The sports_market and sports_selection can be obtained from the Retrieve the markets and selections. The event_id can be obtained from the Retrieve upcoming events. Here, the sports field should be one of the following options: RACING, AFL, NBA, American Football, Baseball, Basketball, Boxing, Cricket, Darts, Handball, Ice Hockey, Rugby League, Rugby Union, Soccer, Tennis or Volleyball.

Please note that in the "Sports" API, the parameters "competition" and "selection" are not used.