Skip to content

PvP

PvP is a live leaderboard for up to five tokens. Prysm posts one message that ranks them by how much their market cap has moved, and edits that same message every minute. Use it to settle “which of these runs harder” in a DM or a group.

/pvp works in your DM and in groups. In a DM the lists are yours; in a group they belong to the group, and everyone in it sees the same lists.

  1. Send /pvp, a name, then the contracts separated by commas, spaces or new lines:

    /pvp Dog Fight <ca1>, <ca2>, <ca3>

    The name is everything before the first contract, so it can contain spaces. Tokens can be on different chains.

  2. Prysm saves the list and posts the live leaderboard in the same chat (in the same topic, in a forum group).

Anything Prysm can’t use — a bad address, a duplicate, or a sixth token — is listed in a short Skipped invalid: … reply. The list is still created with the rest.

🏆 Dog Fight
🪙 WIF   📈 +8.4%
🪙 BONK  📈 +2.1%
🪙 MYRO  📉 -3.7%

#   TOKEN  CA     MCAP     BUYS
1.  WIF    ·4k2P  $1.13B   58
2.  BONK   ·a8Hr  $1.92B   124
3.  MYRO   ·m2Vz  $4.98M   31

🔔 Updates every 60s · stops in 14m
Chart : 1 2 3
  • Top lines — each token and its % change, best first.
  • Table — rank, ticker, the last 4 characters of the contract, current market cap (<$1K means under $1,000) and buys in the last 5 minutes.
  • Footer — time left. It changes to ⏸ Paused after Stop and ✓ Session ended when time runs out.
  • Chart — tap a number to open that token’s chart.
Button What it does
Stop Pauses the race. The message shows Start and Share instead.
Extend +15m Adds 15 minutes. Hidden once the race reaches its maximum length.
Share Posts a share link for this list in the chat where you tapped it.
Start On a paused or finished race: runs it again for a fresh 15 minutes.

A race runs for 15 minutes. Extend can take it to 30 minutes at most. After that, tap Start for another 15 minutes.

Who can use the buttons: in a group, anyone in the group can control races of the group’s lists. Anywhere else, only the person who started the race can.

Send /pvp on its own to see the help and a button for each saved list. Tap a list to start a new race with it.

Command What it does
/pvp <name> <ca1>,<ca2>,… Create a list and start a race.
/pvp Show your saved lists (or the group’s) with tap-to-start buttons.
/pvp stop <name> Stop the running race for that list.
/pvp rename <old> <new> Rename a list.
/pvp delete <name> Delete a list. Any race running from it stops.

List names must be different within the same DM or group. Each DM and each group can keep five saved lists by default. At the limit, delete one with /pvp delete <name>, or contact the bot owner for a higher limit.

  1. Tap Share under a race. Prysm posts a link in that chat.

  2. Anyone who opens the link gets a preview in their DM with @prysm, showing the list name, how many tokens it has and who shared it. Pasting the link as a message in a group where Prysm can read messages shows the same preview in that group.

  3. They pick one of two buttons:

    • 🚀 Spawn Live — starts a race of your list right there. The % change still counts from when you created it.
    • 💾 Save — saves a copy as their own list (in their DM, or in the group if they tap it in a group). The copy’s % change counts from the moment it was saved. If the name is taken, the copy gets (copy) added.

Saving a copy counts toward the saved-list limit. Opening a link to your own list just tells you to use /pvp. If the list was deleted, the link reports that it’s no longer available.

Reply Meaning
Usage: /pvp <name> <ca1>,<ca2>,... A name was sent without contracts, or the contract came first.
You already have a PvP list called '…' Pick another name, or delete the old list first.
No valid contract addresses found. None of the contracts could be used.
No PvP list named '…' found. Check the name with /pvp.
No active PvP session for '…'. That list isn’t racing right now.