Create a PvP Session

By the end of this page you’ll have a live PvP session running with at least two tokens — a leaderboard message that re-ranks every 60 seconds, with Stop, Extend +15m, and Share buttons under it.

The shape of /pvp

/pvp is one command with two modes. Run it bare to see what’s already saved. Run it with a name and contracts to create a list and launch a session in the same step.

/pvp                                — show help + saved lists
/pvp <name> <ca1>,<ca2>,...         — create a list and spawn a session
/pvp delete <name>                  — delete a saved list
/pvp rename <old> <new>             — rename a saved list
/pvp stop <name>                    — stop the active session for a list

Names can contain spaces — Prysm splits on the first contract-shaped substring it finds, so everything before that is the name and everything from that point on is the address list.

Walkthrough — your first session

You want to race PEPE, WIF, and BONK against each other.

1. Send /pvp in your DM with Prysm. With no saved lists you’ll see the help text. With one or more saved lists you’ll see the help plus a tap-to-spawn button for each one.

2. Pick a name and gather your contracts. 2–5 tokens per list. Mixed chains are fine — Prysm detects each address’s chain automatically.

3. Send the create command. Name first, then the contracts separated by commas, spaces, or newlines:

   /pvp Memecoin Brawl 0x6982508145454ce325ddbe47a25d4ec3d2311933, EKpQGSJtjMFqKZ9KQanSqYXRcF8fBopzLHYLDMyLoBmu, DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263

4. Prysm captures starting market caps and posts a leaderboard message in the same chat. Each row’s percentage tracks how far the token has moved from its market cap at session start.

5. Watch the ranks shuffle. The message edits in place every 60 seconds — no spam, no new messages. The footer counts down the time remaining.

What the session message looks like

A freshly-spawned session with three Solana tokens, one Ethereum token. The header lines list each token with its chain emoji, symbol, and percent-change since session start, sorted by performance. The table shows the same rows with rank, CA tail, current market cap, and last-five-minute buy count.

🏆 Memecoin Brawl

🪙 BONK    📈 +12.4%
🪙 WIF     📈 +3.1%
🔹 PEPE    📉 -2.8%
🪙 POPCAT  📉 -5.6%

#   TOKEN  CA     MCAP     BUYS
1.  BONK   ·xKpL  $2.34B   142
2.  WIF    ·8wDr  $1.87B   89
3.  PEPE   ·1933  $3.21B   267
4.  POPCAT ·oBmu  $412M    34

🔔 Updates every 60s · stops in 15m

Chart : 1 2 3 4

The numbered Chart links at the bottom open your default chart provider (DexScreener unless you’ve changed it in /settings) for each row.

Note

The header row’s chain emoji renders as a custom Telegram emoji on clients that support it — that’s why the same chain may appear as a larger animated icon in your real session than the unicode fallback shown here.

Session lifecycle

A new session runs for 15 minutes by default. The buttons under the message let the creator control it from there.

Button	What it does
Stop	Pauses the session immediately. The message switches to a paused state with Start and Share buttons so you can relaunch later.
Extend +15m	Adds another 15 minutes to the countdown. Disappears once you’d be over the 30-minute hard cap.
Share	Generates a deep link other people can tap to clone the list or spawn it themselves.

Once the timer hits zero the message is rewritten with a “Session ended” footer, the leaderboard freezes on its final ranking, and the Start / Share buttons appear so anyone can relaunch the same list. Live sessions can be controlled only by their creator (or by any group member, if the list belongs to a group — see below).

DM vs group

/pvp works the same in both. The only meaningful difference is who owns the list:

• In your DM, the list belongs to you. It only shows up when you run /pvp, and only you can control its sessions.
• In a group, the list belongs to the group. Any member of the group sees it under /pvp in that chat, and any member can spawn, stop, or extend its sessions.

A group’s lists are completely separate from each member’s personal lists — the same name can exist in both places without conflicting.

Limits and caps

Cap	Default	Scope
Tokens per list	2–5	Per list
Saved lists	5	Per user (DM) and per group
Initial session length	15 min	Per session
Maximum session length	30 min	Per session, via Extend

Hit the 5-list cap and /pvp returns:

You've hit the 5-list cap. Delete an existing list with /pvp delete <name> or upgrade to add more.

Delete a list you no longer need with /pvp delete <name>, or contact the bot owner to request a higher limit.

What can fail

A few one-line replies you may hit while creating a list:

• Missing arguments. Send /pvp alone (no name, no contracts) and Prysm replies with the help text plus your saved lists. Pass a name with no contracts and you’ll get Usage: /pvp <name> <ca1>,<ca2>,....
• Name already taken.

  You already have a PvP list called 'Memecoin Brawl'. Pick a different name or run /pvp delete Memecoin Brawl first.

• No valid addresses. Every contract you passed failed validation (bad format, no DEX pair, or the contract isn’t deployed).

  No valid contract addresses found. Provide at least one valid address.

• Some addresses skipped. The list still gets created with the ones that passed, but Prysm calls out the rejects in a follow-up message:

  Skipped invalid: 0xabc…1234, 0xdef…5678

  Duplicates count as skipped too — only one entry per chain-and-contract pair is added, and anything past five tokens is dropped.

Spawning a saved list

Once a list exists, you don’t need to retype the contracts to start a fresh session. Send /pvp and tap the button labelled with your list’s name:

⚔️ PvP — Live Token Battle

Create a live leaderboard that pits 2-5 tokens
against each other and updates every minute.

Your lists: tap to start

[ Memecoin Brawl ]
[ L1 Heavyweights ]
[ Solana Dogs ]

A tap spawns a fresh session for that list in the current chat. The list itself is unchanged — you can spawn the same list as many times as you like. List management beyond create/spawn (rename, delete, share, clone) is covered in the next page.

Where to next

Sharing & history Share a list via deep link so others can clone or spawn it, and replay past sessions.

PvP mode overview What PvP solves, how the leaderboard ranks, and when a session is the right tool.