For the complete documentation index, see llms.txt. This page is also available as Markdown.

Hosting a competition

Add the bot to your group and run a competition. Host commands are for group admins.

Bring the bot into your group and run the show. Hosting commands are for group admins.

1. Add the bot to your group

  1. Add @Layer3TradeBot to your Telegram group.

  2. Make it an admin and grant:

    • Pin messages β€” so the live leaderboard and results stay pinned at the top.

    • Delete messages (optional) β€” lets the bot clean up old leaderboard cards.

The bot works without these, but pinning the leaderboard makes for a much better competition. Grant Pin messages if you can.

2. Start a competition

Run /comp in the group. The bot walks you through the setup:

Setting
What it controls

Buy-in

What each player pays to enter (USDC)

Players

How many seats the competition has

Duration

How long trading runs once it's live

Prize split

Winner-take-all, or split across the top finishers

Confirm, and the bot posts a join card in the group. Players can start buying in.

3. Run the competition

While the competition is filling:

Command
What it does

/resize <N>

Change the player cap. If it fills exactly, the competition starts.

/nudge

DM players who joined but haven't paid (5-minute cooldown).

/cancel

Cancel the competition and refund everyone who paid (two-step confirm).

/fee

Lower the creator fee while filling (creator only).

While the competition is live, if something goes sideways:

Command
What it does

/extend <duration>

Add time to the trading window.

/rescue

Force a refund on a competition stuck in settlement.

4. Creator fee

You can set a small creator fee β€” a slice of the prize pool, capped at 10% β€” when you create a competition. You can only ever lower it afterward with /fee, never raise it. So players always get what they signed up for, or better.

Host checklist

  1. Bot added as an admin (with Pin messages).

  2. /comp run β€” buy-in, players, duration, and split set.

  3. Join card posted, players buying in.

  4. /nudge to round up stragglers.

  5. Competition fills β†’ goes live β†’ settles β†’ winner paid. πŸŽ‰

Command reference

Last updated