Every screen in the bot is reachable from the main menu, but each one also has a
command. Type / in the chat and Telegram lists them.
/start
The command to start with. Any command registers you — send /positions first and
a Ballista user and signing wallet are created for you all the same — but only
/start finishes the job by provisioning the Polymarket account behind it: the
deposit wallet and your deposit addresses. Until that has run once, the other
screens have nothing to read and will tell you your account is not set up.
Provisioning takes a few seconds, so /start posts a ⏳ Loading… placeholder and
replaces it with the menu when it is ready. The placeholder appears every time you
send the command, not just the first. See
Create your account.
Afterwards /start is simply “go home”: it reopens
the main menu with your current balance.
/start is also the target of referral links: opening a t.me referral link
sends it for you and credits the referrer — but only if you are a brand new
user. Clicking someone’s link later has no effect. See
Referrals./buy
Asks you to reply with a Polymarket link, then loads that market and shows the buy
buttons. The link has to be on polymarket.com or one of its subdomains;
everything else is turned away. Full walkthrough in Buying.
/positions
Lists everything you currently hold. See Positions.
/wallet
Your deposit addresses for every supported chain, links to your Polymarket profile,
and the Export Keys button. See Wallet and deposits.
/copytrade
Opens the list of your copy trades, where you can create a new one or open an
existing one to edit. See Copy trades.
/referrals
Your referral code, link and stats. See Referrals.
If you send the bot a plain message when it is not waiting for anything, it
replies with a nudge to send /start or /buy. Text only matters when the bot
has just asked you a question — a limit price, a copy-trade value, a referral
code.
