POKEX

1. Quick Start

3 Steps to Get Started

Step 1: Find a Pokex Post

Go to @playpokex on X and find any post

Step 2: Say "catch"

Reply to the post with "catch" or "catch pokemon" or anything like that

Step 3: Done

50/50 chance to catch. If you succeed you get a random Pokemon with unique stats. If you fail just try again.

No slash commands needed. Just talk naturally.
"catch pokemon" or "throw pokeball" or just "catch" all work

The Agent & Platforms

Pokex is run by an AI agent. You play by mentioning it and typing a command in plain language — the agent reads it, runs the game logic, and updates your account instantly.

Reply limit (3 per hour per user)

To keep the accounts healthy the agent posts at most 3 public replies per hour per user. If you are over that limit, your command still runs and your game still updates — it just won't post a public reply. Nothing is lost.

Agent section (commands vs replies)

Every command the agent processes is listed at poke-x.xyz/agent and on the home page. Each one is tagged Replied (the agent answered you on the platform) or Command (processed silently because it was over the hourly reply limit). So even when the agent stays quiet, you can always see your result there.

Platforms

X (Twitter) is the main platform and is live now — mention @playpokex to play.

Support for Reddit and Pump.fun Communities has also been added to the agent. The same commands (catch, check, feed, battle, evolve and the rest) will work there too.

Reddit and Pump.fun Communities are offline for now and will be switched on in a later update once their accounts are set up. You can see the live online / offline status of each platform on the home page and the agent section.

2. All Commands

Reply to any @playpokex post on X. No special format — just talk naturally.

catch

Catch a wild base-form Pokémon. 50/50 chance. Party max 3 — overflow goes to your Box.
"catch" / "catch pokemon" / "throw pokeball"

check

See your Pokémon stats. Say a name or number to check one, or just "check" for all.
"check" / "check pikachu" / "how is my first"

feed

Feed your Pokémon anything. 60-min cooldown per Pokémon.
"feed" / "feed my second berries" / "give charizard pizza"

battle

Battle a random trainer or Gym Bot. 30-min cooldown per Pokémon after each battle.
"battle" / "fight" / "1v1" / "send charizard"

evolve

Evolve your Pokémon once it hits the required level. Check the site to see if it's ready.
"evolve" / "evolve pikachu" / "evolve my first"

swap [name]

Move a Pokémon from your Box into your active party.
Party full? Say "swap [boxname] for [partyname]" to swap them out.
"swap gastly" / "swap gastly for pikachu"

release [name] confirm

Permanently release a Pokémon. Must include "confirm" to prevent accidents.
"release pikachu confirm" / "release my first confirm"

challenge @trainer (PvP)

Challenge a specific trainer to a direct 1v1. They reply "accept" to battle.
"challenge @trainer" / "pvp @trainer" / "battle @trainer"

accept / decline / cancel

Accept an incoming PvP challenge, decline all, or cancel your own outgoing challenge.
Also: reply "accept" to confirm a wager challenge and lock in your team of 3.
"accept" / "decline" / "cancel"

wager @trainer AMOUNT

Challenge a trainer to a $Pokex-staked 3v3 battle. Both must have 3 wager-eligible party Pokemon. Both reply "accept" then send the exact token amount shown at poke-x.xyz/me.
"wager @rival_gary 1000"

trade @trainer [your pokemon] for [their pokemon]

Propose a Pokemon trade. The other trainer accepts or declines at poke-x.xyz/me
Omit "for" to gift your Pokemon without asking for anything back.
"trade @rival_gary pikachu for charizard" / "trade @rival_gary eevee"

tournament join

Join the current open tournament. 8-player single-elimination bracket.
"tournament join" / "@playpokex tournament join"

activity

Send your Pokémon on an adventure with another trainer's Pokémon. 2-hour cooldown.
"walk" / "explore" / "take pikachu for a walk"

help

Show a quick command list in the reply.
"help" / "commands" / "how do i play"

chat

Ask anything about Pokémon or the game — Pokex will talk back.
"whats the best fire type?" / "tell me about ghost pokemon"

3. Pokeball System

Three pokeball tiers. Better balls = higher catch rate and shiny rate. Buy at poke-x.xyz/shop or directly from your profile.

pokeball — free daily

ultra ball — 2,000 $pokex

master ball — 5,000 $pokex

Pokeball (free) — 40% catch rate, 1% shiny. You get 5 free pokeballs every day at midnight UTC. Purchased pokeballs stack on top of your free ones.

Ultra Ball (2,000 $Pokex) — 65% catch rate, 4% shiny. Best value for shiny hunters — 4x the shiny odds of a regular pokeball.

Master Ball (5,000 $Pokex) — 85% catch rate, 8% shiny. Pity system: after 10 failed throws in a row, the next throw is guaranteed to succeed. Counter resets on any successful catch.

Using Balls on X

Default: "catch" uses a regular pokeball (free daily stock first)
Ultra Ball: "catch ultra ball" or "ultra ball catch"
Master Ball: "catch master ball" or "master ball catch"
Bot tells you how many of that type you have left after each throw

buying pokeballs

go to poke-x.xyz/shop or click "Buy Pokeballs" on your profile
select ball type and quantity
get a unique $Pokex amount (e.g. 2000.000243)
send exactly that amount to the pool token account
click confirm — balls added instantly

4. Catching Pokémon (Updated)

Only base-form (Stage 1) Pokémon can be caught in the wild — 458 species across all 8 generations. Higher evolutions must be reached through evolution.

success — gotcha! pokémon caught

fail — pokémon broke free, try again

Catch rate: 50/50 on every attempt.
Party limit: Max 3 Pokémon in your active party.
Overflow: If your party is full, the caught Pokémon goes straight to Box 1.
Stage 1 only: All wild Pokémon are base-form. No evolved forms in the wild.
Shiny chance: 1.5% — extremely rare. Bot says "a shiny one!" if you hit it.

example catch

you:    "catch pokemon"
pokex:  "gotcha! you caught Bulbasaur the Grass type.
         feed them, check on them or battle anytime"

4. Feeding System

Feed your Pokémon to keep them happy, grow them, and increase their feed count.

feed card — pokémon reacts to whatever you give them

How to feed:
"feed" → feeds your first Pokémon
"feed my second berries" → pick which Pokémon and what food
You can give them anything — pizza, ramen, berries, etc.

Cooldown: 60 minutes per Pokémon between feeds.
Growth: Feed count increases growth stage (Baby → Teen → Adult).

Hungry Pokémon are unhappy Pokémon. Feed them regularly.

5. Evolution System

Train your Pokémon through battles to hit the required level — then evolve them into their next form.

status card — check your level before evolving

check card — see level, xp, and stats

How to Evolve

1. Battle to earn XP and level up your Pokémon
2. Check the website (poke-x.xyz/me) — a green "Ready to Evolve" badge appears when it's time
3. Reply to a @playpokex post with "evolve" or "evolve [name]"
4. Your Pokémon transforms — sprite updates on the site

Branching evolutions:
Some Pokémon have multiple evolution paths (e.g. Slowpoke → Slowbro or Slowking, Eevee → 8 forms).
The first branch is used by default for now. More control coming with the item system.

Level requirements vary:
Caterpie → Metapod at level 7
Bulbasaur → Ivysaur at level 16
Magikarp → Gyarados at level 20
Check the Pokédex for any Pokémon's evolution level.

Evolution stages:
Stage 1 = base form (catchable in the wild)
Stage 2 = first evolution (only via evolve command)
Stage 3 = final evolution (only via evolve command)

6. Box System (Box 1 & Box 2)

Your party holds 3 active Pokémon. Extra Pokémon are stored in Box 1 and Box 2 — both are wager-eligible when the Wager System launches.

team card — active party of 3 pokémon

Party vs Box:
Active Party (max 3) — can battle, feed, evolve, and be used in PvP
Box 1 & Box 2 — storage; wager-eligible, no active actions

Overflow: When your party is full and you catch a new Pokémon, it goes to Box 1 automatically.

Swap via X

"swap gastly" → move Gastly from box to party (if party has space)
"swap gastly for pikachu" → swap them when party is full
Party slot opens up → old Pokémon goes to box, new one joins party

Manage via Website

Login at poke-x.xyz with your X account
Go to My Pokémon (/me) to see Party, Box 1, and Box 2
Click "→ Party" on any box card to bring it into your party
Click "Send to Box" on a party card to move it to storage
Click "→ Box 2" to move between boxes

Battle lock: If your Pokémon has a pending PvP challenge on X, it is locked and cannot be swapped until the challenge resolves or expires (30 min).

Wager eligibility:
Only party Pokemon (not boxed) are used in wagers — you pick your active team of 3 when you challenge or accept.
Legacy Pokemon (caught before the eligibility patch) cannot enter wagers.
See the Wager System section for full details.

7. Battle System (Real Stats)

Every Pokémon has real base stats from the official Pokédex. Species matters — a Mewtwo at level 1 is genuinely stronger than a Rattata at level 1.

battle card — turn-by-turn result with HP

lv.58 raichu beats lv.1 mewtwo — level gap matters

How Battles Work

Each species has real HP, Attack, Defense, Speed stats from the Pokédex.
Effective stats scale with level — atk grows faster than def, so higher levels hit harder.
Speed determines who attacks first each round — faster Pokemon goes first every time.
Level also improves speed (effectiveSpeed = baseSpeed + level × 2).
Type advantages still apply — Fire beats Grass, Psychic beats Fighting, etc.
10 rounds max — if both standing, winner is whoever has more HP% remaining.

Species tiers (same level):
Legendary (Mewtwo, Rayquaza) beats Pseudo-legendary (Dragonite, Salamence)
Pseudo-legendary beats Fully evolved starters (Charizard, Blastoise)
Fully evolved beats base-stage (Pikachu, Eevee, Rattata)

Level gap example:
Pikachu lv.55+ beats Mewtwo lv.1 — the crossover is around level 55 for Pikachu.
Rattata lv.100 beats Mewtwo lv.1 — grind matters.

XP rewards:
Win vs player = +25 XP | Lose vs player = -25 XP (protected at lv.1–2)
Win vs Gym Bot = +25 XP | Lose vs Gym Bot = -50 XP
XP never goes below 0. Level never decreases.

30-minute battle cooldown per Pokémon.
Rotate your 3 party Pokémon to battle every ~10 min.

8. PvP Challenges

Call out a specific trainer on X for a direct 1v1 Pokémon battle.

pvp card — trainer vs trainer result

activity card — pokémon adventures with a friend's

Full PvP flow:
1. You: "challenge @rival" → challenge sent, your Pokémon is locked
2. Rival: "accept" → battle resolves automatically
3. Both trainers get XP result posted on X
4. Your Pokémon unlocks after the battle

Challenge commands:
"challenge @trainer" / "pvp @trainer" / "battle @trainer" → send
"accept" → accept oldest pending challenge
"decline" → decline all incoming
"cancel" → cancel your outgoing challenge (unlocks your Pokémon)

Rules:
Challenges expire after 30 minutes — Pokémon unlocks automatically
Multiple trainers can challenge you — they queue up
Your Pokémon is locked during a pending challenge — cannot be swapped or boxed

Rewards:
Win = +25 XP | Lose = -25 XP (never below 0)

9. Gym Battles + Medals

When no real opponent is within ±5 levels, Pokex sends in a Gym Bot. Beat them to earn a medal shown on your profile. 13 gyms scaling from Level 3 to Level 200.

gym battle — elesa's raichu vs your pikachu

beat the gym to earn a medal on /me

13 Gym Leaders — in order of difficulty:
1. Cheren (Rattata Lv.3) — 2. Skyla (Pidgeot Lv.10) — 3. Elesa (Raichu Lv.18)
4. Shauntal (Gengar Lv.28) — 5. Drayden (Dragonite Lv.40) — 6. Caitlin (Mewtwo Lv.55)
7. Marlon (Gyarados Lv.70) — 8. Grimsley (Houndoom-Mega Lv.90) — 9. Iris (Salamence Lv.110)
10. Colress (Metagross Lv.130) — 11. N (Rayquaza Lv.150) — 12. Ghetsis (Mewtwo-MegaX Lv.175)
13. Alder (Kyogre Lv.200)

Gym Medals

Beat a Gym Leader → earn that gym's medal on your poke-x.xyz/me profile.
Each medal is only awarded once — can't farm the same gym for multiple medals.
Gym Bots are stronger than average players (+powerMult, +hpMult).
Losing to a Gym costs -50 XP vs -25 for a player loss — it's harder.

10. Wager System (Live — Mainnet)

Stake $Pokex tokens on a 3v3 Pokemon battle. Both trainers bring a full team of 3. No wallet connection needed — just send the exact token amount shown to the pool address.

wager battle — $pokex on the line, 3v3 real stats decide the winner

Eligibility: You and your opponent each need exactly 3 wager-eligible party Pokemon (not in a box).
Legacy Pokemon (caught before the eligibility patch) cannot enter wagers.
Teams are locked the moment you each say "accept" — you cannot swap after that.

How to Start a Wager

1. Reply "@playpokex wager @opponent 1000" on any post (amount = $Pokex tokens)
2. Bot confirms your team of 3 and tags your opponent
3. Opponent replies "accept" to lock in their own team
4. Login at poke-x.xyz/me to see your unique payment amount
5. Send the exact $Pokex amount shown (e.g. 1000.000243) to the pool wallet address shown on the page
6. Click "Check Payment" — once both sides pay, battle runs automatically

3v3 Battle Format

Pokemon fight one-on-one in sequence — first vs first, second vs second, etc.
HP carry-over: the winner of each duel keeps their remaining HP going into the next fight.
First trainer to knock out all 3 of the opponent's Pokemon wins the wager.
A trainer with any surviving Pokemon at the end wins, even if they lost one or two duels.

Unique amounts: Each wager side gets a unique fractional token amount (e.g. 1000.000243 $Pokex) so the system knows which payment belongs to which trainer. Do not round it.

15-minute window: Both trainers must pay within 15 minutes of accepting. Miss the window and the wager auto-cancels. Anyone who paid gets an automatic refund.

Fee: 5% of the total pot is permanently burned on-chain — removed from total supply forever. Winner takes 95% of what both sides sent.

Cancel button: Always available for pending-accept challenges and for accepted wagers where neither side has paid yet. Once a payment is made, cancel is available only after the 15-minute deadline passes. Pending-accept wagers auto-cancel after 24 hours if not accepted.

Battle lock: Your active Pokemon is locked while a wager is pending — you cannot swap or box it. The lock is released automatically when the wager completes or cancels.

Example — 1000 $Pokex wager:
Alice sends 1000.000243, Bob sends 1000.000571 $Pokex
Pool holds 2000.000814 total
Alice's team wins the 3v3
Alice receives 1900 $Pokex (95%). ~100 $Pokex permanently burned, supply reduced.

Token: $Pokex — Solana mainnet, Token 2022 program
CA: CcZShPVDmsVfWToqiM2zkSgfeXJjn38XkG1TuLtkpump
One active wager per trainer at a time. Minimum 1 $Pokex.

11. Trading Pokemon

Propose a Pokemon swap with any trainer on X. The other trainer accepts or declines on the website.

trade offer sent — target trainer confirms at poke-x.xyz/me

Trade Flow

1. Reply "trade @trainer [your pokemon] for [their pokemon]"
2. Bot posts confirmation tagging both trainers
3. Target trainer logs into poke-x.xyz/me — sees Accept / Decline buttons
4. Accept = both Pokemon swap owners instantly
5. Decline = trade cancelled, nothing moves

Gift (no return): "trade @trainer [pokemon]" — you send without asking for anything back

Only active party Pokémon can be traded (not boxed ones).
One pending trade per trainer at a time. Both Pokémon must exist in their active parties.

trade examples

you:    "trade @rival_gary pikachu for charizard"
pokex:  "@trainer_ash @rival_gary trade offer: trainer_ash's
         Pikachu for rival_gary's Charizard. rival_gary —
         login at poke-x.xyz/me and accept or decline."

you:    "trade @newbie_joe bulbasaur"
pokex:  "@trainer_ash @newbie_joe trainer_ash sends Bulbasaur
         to newbie_joe. newbie_joe — accept at poke-x.xyz/me"

12. Tournament

8-player single-elimination bracket. Join on X, battles run automatically, bracket is public at poke-x.xyz/tournament.

How to Join

When a tournament is open: reply "tournament join" to any @playpokex post
Or click "Join Tournament" at poke-x.xyz/tournament
First 8 trainers to sign up get seeded (seeded 1–8 by wins)
Bracket: Quarterfinals → Semifinals → Final

Bracket format: Seeding 1 vs 8, 2 vs 7, 3 vs 6, 4 vs 5
Each match uses both trainers' strongest-level active Pokemon.
Real species stats + level formula — rarity and grind both matter.
Match results post publicly to X. Check poke-x.xyz/tournament for live bracket.

Prize: Set by the tournament organizer — $Pokex, bragging rights, or both.

join a tournament

you:    "tournament join"
pokex:  "@trainer_ash registered for the tournament.
         5/8 spots filled. bracket at poke-x.xyz/tournament"

13. Shiny Pokemon

Ultra-rare variants of any catchable Pokemon. Different colored sprite. Shown with a purple "shiny" badge on your profile.

shiny eevee — bot says "a shiny one!" when you hit it

Catch chance: 1.5% per catch attempt (roughly 1 in 67).
Display: Sprite shown with a purple hue-shift on poke-x.xyz/me. "shiny" badge on the card.
Stats: Same species stats — shiny is cosmetic bragging rights, not a stat boost.
Trade value: Shinies are rarer than legendaries in practice — high trade/wager value.

shiny catch

you:    "catch"
pokex:  "@trainer_ash gotcha you caught a shiny one!
         Eevee the Normal type. feed them, check on them
         or battle anytime"

14. Trainer Level

Your personal level as a trainer — separate from Pokemon levels. Based on total battle wins. Shown as a badge on your poke-x.xyz/me profile.

10 Trainer Levels — wins required:
Lv.1 = 0 wins | Lv.2 = 2 wins | Lv.3 = 4 wins | Lv.4 = 7 wins | Lv.5 = 12 wins
Lv.6 = 20 wins | Lv.7 = 35 wins | Lv.8 = 60 wins | Lv.9 = 100 wins | Lv.10 = 200 wins

Key difference from Pokemon level:
Releasing a Pokemon does NOT reset your trainer level — wins are yours forever.
Trainer level tracks YOU, not your current team.

Leaderboard: Ranked by trainer wins — not individual Pokemon wins.

Trainer level is shown as "Trainer Lv.X" next to your name on your /me profile.
All battle types count — PvP, gym bots, random battles all increment your trainer wins.

15. Cooldown Reference

All cooldowns are per Pokémon, not per trainer. Rotate your party to keep playing.

Battle cooldown: 30 minutes
After each battle (regular or PvP), that Pokémon rests for 30 min.
With 3 party Pokémon you can battle every ~10 min by switching.

Feed cooldown: 60 minutes
Each Pokémon can be fed once per hour.

Activity cooldown: 2 hours
Sending a Pokémon on an adventure has a 2-hour rest after.

PvP challenge expiry: 30 minutes
Unanswered challenges expire automatically. Pokémon unlocks.

cooldown summary

battle   ──  30 min  per pokemon
feed     ──  60 min  per pokemon
activity ──   2 hrs  per pokemon
pvp lock ──  30 min  (auto-expires if not accepted)

16. Growth & Leveling

Two separate systems track your Pokémon's progress — growth stage (feeds) and level (battles).

Growth stages (feed-based):
Baby — 0–2 feeds
Teen — 3–5 feeds
Adult — 6+ feeds

Level (XP from battles):
Every win earns +25 XP. XP fills a bar — hit the threshold to level up.
Higher level = better battle stats.
Level determines evolution eligibility (e.g. Bulbasaur needs level 16 to evolve).

XP protection for new trainers:
Level 1–2: no XP lost on defeat
Level 3–4: reduced XP lost (-10 vs player, -20 vs gym)
Level 5+: full XP stakes apply

17. Managing Your Team

Up to 3 active Pokémon in your party. Unlimited storage in Box 1 and Box 2.

Picking a Pokémon

By name: "feed charizard" or "battle pikachu"
By number: "check my first" or "battle my 2nd"
No pick → defaults to first Pokémon in party

Releasing a Pokémon

"release pikachu confirm" — frees up a party slot
Must include "confirm" to prevent accidents
Pokémon is gone permanently — be sure before releasing

Team tip:
Keep varied types in your party for type-advantage flexibility.
Use your box to store Pokémon you want to keep but aren't actively training.

18. Website Features

Visit poke-x.xyz to track your Pokémon, manage your box, and browse the Pokédex.

X Login → My Pokémon (/me)

Click "Login with X" to sign in with your X account
See your full party and both box slots side by side
Evolution indicator — green "Ready to Evolve" badge appears when your Pokémon hits its level
Swap buttons — move Pokémon between party, Box 1, and Box 2 with one click
Battle lock badge — red "locked" banner on Pokémon with a pending PvP challenge

Pokédex (/pokedex)

Browse all 458 catchable base-form Pokémon
Filter by type, rarity, or search by name
Sort by A–Z, most owned by trainers, or rarity tier
See how many trainers own each species — or if it's still uncaught
Rarity tiers: Common → Uncommon → Rare → Legendary → Mythical

Leaderboard (Homepage)

Top trainers ranked by total wins across all Pokémon
Updates in real time as battles happen on X

19. Tips & Tricks

Pro trainer tips:
Rotate your 3 party Pokémon to battle every 10 min instead of waiting 30
Check /me on the site — green badge = ready to evolve, don't wait
Use type advantages in PvP — Psychic beats Fighting, Water beats Fire
Legendary Pokemon (Mewtwo, Rayquaza) are genuinely stronger — hunt or trade for them
Wager only when your team of 3 is strong — all 3 fight with HP carry-over
Do not round wager payment amounts — the exact decimals fingerprint your transaction
Shiny Pokemon are rare (1.5%) and have high trade value even though stats are the same
Trainer level persists even if you release Pokemon — grind wins, not Pokemon count

Natural language — all of these work:
"catch pokemon" / "throw pokeball" / "catch" = catch
"how is pikachu" / "check my first" / "status" = check
"give berries" / "feed ramen" / "feed" = feed
"lets fight" / "1v1" / "battle my second" = battle
"evolve" / "evolve pikachu" / "make it evolve" = evolve
"swap gastly" / "bring gastly out" = swap from box
"wager @rival_gary 0.5 sol" = start a SOL wager
"trade @rival_gary pikachu for charizard" = propose a trade
"tournament join" = join the open tournament

20. Coming Soon

Quest System
Complete daily and weekly quests for $Pokex rewards, rare Pokemon, and exclusive badges.

Clan System
Form clans with other trainers. Clan battles, shared leaderboard, group tournaments.

Trainer Shipments
Gift starter Pokemon packages to onboard new trainers directly — spread the game.

Follow @playpokex on X for every update.
Early trainers are eligible for the $Pokex airdrop.