Triggers

Triggers are events that activate you Bot and set them in motion.

First, the user selects an exchange to obtain market data that will trigger the bot. Then, they choose the type of trigger, asset pair, and relationship (price greater than, less than, equal to, etc.). Finally, they set the gas fee that can be used by this bot.

This settings screen will be used until it is replaced by a prompt in the future.

Some Examples:

• Price of an asset crosses a certain value

• Price of an asset moves by a certain percentage in any direction

• TVL crosses a certain value

• The MarketCap of an asset moves by a certain value

• 100-200 EMA Crossover on 4h timeframe, and many more technical analysis triggers

🤖 DEX/AMM

The following triggers can be used in DEX/AMM. Please check the development status as well. For more details, please contact the team.

Function Name	Category	Variable	Explanation	Example	Availability
period_exc()	Periodic Execution	period, unit, n	Triggers to be executed periodically	period_exc(1,hour,2) means buy btc 2 times per hour	🛠
price()	Market Data	marketName, minutes(optional)	Takes a market name as an argument and returns the final price of the asset. When user input n, it returns the price n minute before the asset.	price("ETH/USD",7) returns the price 7 minute before ETH/USD.	🛠
last_trade_price()	Market Data	marketName	Returns the last traded price of the asset.	last_trade_price("LINKBULL/USD") Returns the last trade price for that asset.	🛠
free_collateral	Account Data	-	Returns the amount of collateral not required in U.S. dollars in the Wallet.	free_collateral>500. This rule is triggered when the collateral-free amount in the wallet exceeds $500.	🛠
total_position_size	Account Data	-	Returns the total account position size (in USD) for all futures.	total_position_size<2*total_collateral This rule is triggered when the total position is less than twice the collateral in the account.	🛠
position()	Position Data	marketName	Returns the size of the asset position. Returns a positive value or 0.	position("BTC-USDC") returns the size of the BTC position in spot.	🛠
position_side()	Position Data	marketName	Returns 1 if the position is long, -1 if the position is short, or 0 if the position is neither.	position_side("ETH-USDC")Returns 1 if ETH bought.	🛠
abs()	Math Function	x	Takes a numeric value as an argument and returns its absolute value.	In the case of abs(-2), 2 is returned.	🛠
max()	Math Function	x,y	The two numbers are taken as arguments and return the greater of x and y.	max(3.2, 10) returns 10	🛠
min()	Math Function	x,y	The two numbers are taken as arguments and return the smaller of x and y.	min(1, 5), 1 is returned.	🛠
sqrt()	Math Function	x	Takes a positive number and returns its square root.	sqrt(25) returns 5.	🛠
floor()	Math Function	x	Takes a numeric argument and returns the largest integer less than or equal to x.	floor(2.5) returns 2.	🛠
ceil()	Math Function	x	Takes a numeric argument and returns the smallest integer greater than or equal to x.	ceil(2.5) returns 3.	🛠
sign()	Math Function	x	It takes a numeric argument and returns 1 for positive values and 0 for negative values.	sign(10) returns 1 and sign(-5) returns 0.	🛠
get_variable()	Others	name	It takes a variable name as an argument and returns the value stored in this variable.	When you store 10 in the variable named myVariable. In that case, get_variable('myVariable') returns 10.	🛠
time	Others	Returns the current UNIX time.			🛠
minute	Others	Returns only the minute of the current time.			🛠
hour	Others	Returns only the current Universal Standard Time.			🛠

🤖 Perpetual DEX

Function Name	Category	Variable	Explanation	Example	Availability
period_exc()	Periodic Execution	period, unit, n	Triggers to be executed periodically	period_exc(1,hour,2) means buy btc 2 times per hour	🛠
price()	Market Data	marketName, minutes(optional)	Takes a market name as an argument and returns the final price of the asset. When user input n, it returns the price n minute before the asset.	price("ETH-PERP",7) returns the price 7 minute before ETH/USD.	🛠
bid_price()	Market Data	marketName	Returns the highest bid price for the asset.	bid_price("ETH-PERP") returns the highest bid price for ETH/USD.	🛠
offer_price()	Market Data	marketName	Returns the highest offer price for the asset.	offer_price("XRP-PERP") returns the highest offer price for XRP-PERP.	🛠
bid_volume()	Market Data	marketName	Returns the highest bid volume for the asset.	bid_price("ETH-PERP") returns the highest bid volume for ETH/USD.	🛠
offer_volume()	Market Data	marketName	Returns the highest offer volume for the asset.	offer_price("XRP-PERP") returns the highest offer volume for XRP-PERP.	🛠
last_trade_price()	Market Data	marketName	Returns the last traded price of the asset.	last_trade_price("LINKBULL/USD") Returns the last trade price for that asset.	🛠
index_price()	Market Data	marketName, minutes(optional)	Returns the index price "n" minutes ago for that asset.	index_price("LINK-PERP", 33) returns the index price 33 minutes before LINK-PERP.	🛠
premium()	Market Data	marketName	Returns the asset's futures premium (mark price divided by index price).	premium("ETH-PERP") returns the ETH-PERP premium.	🛠
collateral	Account Data	-	Returns the total amount of collateral in U.S. dollars in the wallet.	collateral>500 This rule is triggered when the total amount of collateral in the wallet exceeds $500.	🛠
free_collateral	Account Data	-	Returns the amount of collateral not required in U.S. dollars in the Wallet.	free_collateral>500. This rule is triggered when the collateral-free amount in the wallet exceeds $500.	🛠
total_position_size	Account Data	-	Returns the total account position size (in USD) for all futures.	total_position_size<2*total_collateral This rule is triggered when the total position is less than twice the collateral in the account.	🛠
margin_fraction	Account Data	-	Returns the account margin ratio, i.e., the ratio of the total position size in the account to the collateral.	margin_fraction>1	🛠
open_margin_fraction	Account Data	-	Returns the margin percentage including open orders.	open_margin_fraction>1	🛠
leverage	Account Data	-	Returns the approximate account leverage multiplier, which is the rate of collateral and total position size for the course.	leverage<10 This rule is triggered when leverage is below 10x.	🛠
initial_mfr	Account Data	-	Returns the initial margin requirement.	-	🛠
Maintenance_mfr	Account Data	-	Returns the account maintenance margin percentage requirement.	-	🛠
Liquidation_distance:	Account Data	-	Returns the approximate status of how close your account is to liquidation.	-	🛠
position()	Position Data	marketName,side	Returns the size of the asset position. Returns a positive value or 0.	position("ALGO-PERP". buy") returns the size of the ALGO-PERP long.	🛠
position_side()	Position Data	marketName	Returns 1 if the position is long, -1 if the position is short, or 0 if the position is neither.	position_side("ETH-PERP")Returns 1 if ETH bought.	🛠
position_net()	Position Data	marketName	Returns the net size of the position. Positive for long, negative for short.	position_net("BTC-PERP") returns the net size of BTC-PERP.	🛠
position_leverage()	Position Data	marketName	Returns the approximate leverage of the position.	position_leverage("EOS-PERP") returns the approximate leverage of an EOS-PERP position.	🛠
position_notional()	Position Data	marketName	Return the notional amount of the position in U.S. dollars for risk.	position_notional("ALT-PERP") returns the notional principal of the ALT-PERP position.	🛠
abs()	Math Function	x	Takes a numeric value as an argument and returns its absolute value.	In the case of abs(-2), 2 is returned.	🛠
max()	Math Function	x,y	The two numbers are taken as arguments and return the greater of x and y.	max(3.2, 10) returns 10	🛠
min()	Math Function	x,y	The two numbers are taken as arguments and return the smaller of x and y.	min(1, 5), 1 is returned.	🛠
sqrt()	Math Function	x	Takes a positive number and returns its square root.	sqrt(25) returns 5.	🛠
floor()	Math Function	x	Takes a numeric argument and returns the largest integer less than or equal to x.	floor(2.5) returns 2.	🛠
ceil()	Math Function	x	Takes a numeric argument and returns the smallest integer greater than or equal to x.	ceil(2.5) returns 3.	🛠
sign()	Math Function	x	It takes a numeric argument and returns 1 for positive values and 0 for negative values.	sign(10) returns 1 and sign(-5) returns 0.	🛠
get_variable()	Others	name	It takes a variable name as an argument and returns the value stored in this variable.	When you store 10 in the variable named myVariable. In that case, get_variable('myVariable') returns 10.	🛠
perpetual()	Others	coin	Takes a coin name as an argument and returns the name of the indefinite futures market associated with this coin.	Since perpetual('ETH') returns ETH-PERP, price(perpetual('ETH')) returns the price of ETH-PERP.	🛠
time	Others	Returns the current UNIX time.			🛠
minute	Others	Returns only the minute of the current time.			🛠
hour	Others	Returns only the current Universal Standard Time.			🛠