Ballsdex · commands

Ballsdex commands

5 most-used commands, as reported by Discord's App Directory on 2026-09-07

Command names and source descriptions are shown in their original language.

Most-used commands

Observed 2026-09-07

Discord's App Directory reports these as the app's most-used commands and does not publish the full set.

/balls

View and manage your countryballs collection.

Default permission: anyone in the server, unless roles restrict it
Runs in: server, bot DM, private channel
Installs: server install, user install

option	type		description
`list`	subcommand		List your countryballs.
`user`	user	optional	The user whose collection you want to view, if not yours.
`sort`	string	optional	Choose how countryballs are sorted. Can be used to show duplicates.choices: alphabetic, catch_date, rarity, special, health, attack, health_bonus, attack_bonus, stats_bonus, total_stats, catch_time, duplicates
`reverse`	boolean	optional	Reverse the output of the list.
`countryball`	string	optional	Filter the list by a specific countryball.
`special`	string	optional	Filter the list by a specific special event.
`filter`	string	optional	Filter the list by a specific filter.choices: only_specials, non_specials, self_caught, traded_only, this_server, frame, favorites, duplicates
`group`	string	optional	Filter the list by a specific group.
`ephemeral`	boolean	optional	Whether or not to send the command ephemerally.
`completion`	subcommand		Show your current completion of the BallsDex.
`user`	user	optional	The user whose completion you want to view, if not yours.
`special`	string	optional	The special you want to see the completion of
`filter`	string	optional	Filter the list by a specific filter.choices: only_specials, non_specials, self_caught, traded_only, this_server, frame, favorites, duplicates
`regime`	string	optional	The regime you want to see the completion of
`economy`	string	optional	The economy you want to see the completion of
`group`	string	optional	The group you want to see the completion of
`duplicates`	boolean	optional	Show the completion of duplicates.
`ephemeral`	boolean	optional	Whether or not to send the command ephemerally.
`info`	subcommand		Display info from a specific countryball.
`countryball`	string	required	The countryball you want to inspect
`special`	string	optional	Filter the results of autocompletion to a special event. Ignored afterwards.
`ephemeral`	boolean	optional	Whether or not to send the command ephemerally.
`last`	subcommand		Display info of your or another users last caught countryball.
`user`	user	optional	The user you would like to see
`filter`	string	optional	Filter the last caught countryball by a specific filter. Only works if the user has caught at least…choices: only_specials, non_specials, self_caught, traded_only, this_server, frame, favorites, duplicates
`index`	integer	optional	How far back to look. 1 is the most recent catch, 2 the one before that, and so on.
`favorite`	subcommand		Set favorite countryballs.
`countryball`	string	required	The countryball you want to set/unset as favorite
`special`	string	optional	Filter the results of autocompletion to a special event. Ignored afterwards.
`drop`	subcommand		Drop one of your countryballs back into the wild, to be caught again.
`countryball`	string	required	The countryball you want to drop
`special`	string	optional	Filter the results of autocompletion to a special event. Ignored afterwards.
`give`	subcommand		Give a countryball to a user.
`user`	user	required	The user you want to give a countryball to
`countryball`	string	required	The countryball you're giving away
`special`	string	optional	Filter the results of autocompletion to a special event. Ignored afterwards.
`bulk_give`	subcommand		Give multiple countryballs to a user at once.
`user`	user	required	The user you want to give countryballs to
`countryball`	string	optional	Filter the selection to a specific countryball
`sort`	string	optional	Choose how countryballs are sorted. Can be used to show duplicates.choices: alphabetic, catch_date, rarity, special, health, attack, health_bonus, attack_bonus, stats_bonus, total_stats, catch_time, duplicates
`special`	string	optional	Filter the selection to a specific special event
`filter`	string	optional	Filter the selection by a specific filterchoices: only_specials, non_specials, self_caught, traded_only, this_server, frame, favorites, duplicates
`count`	subcommand		Count how many countryballs you have.
`countryball`	string	optional	The countryball you want to count
`special`	string	optional	The special you want to count
`filter`	string	optional	Filter the count by a specific filterchoices: only_specials, non_specials, self_caught, traded_only, this_server, frame, favorites, duplicates
`duplicate`	subcommand		Shows your most duplicated countryballs or specials.
`type`	string	required	Type of duplicate to check (countryballs or specials).choices: countryballs, specials
`sort`	string	optional	Choose how the results are sorted. Defaults to most duplicated first.choices: count_desc, count_asc, alphabetic, alphabetic_reverse, rarity, rarity_reverse
`limit`	integer	optional	The amount of countryballs to show (default: all), can only be used with `countryballs`.
`reverse`	boolean	optional	Show your least duplicated countryballs or specials first instead.
`group`	string	optional	Filter the results by a specific group.
`filter`	string	optional	Filter the results by a specific filter.choices: only_specials, non_specials, self_caught, traded_only, this_server, frame, favorites, duplicates
`compare`	subcommand		Compare your countryballs with another user.
`user`	user	required	The user you want to compare with
`special`	string	optional	Filter the results of the comparison to a special event.
`duplicates`	boolean	optional	Whether to compare duplicates.
`filter`	string	optional	Filter the compared countryballs by a specific filter.choices: only_specials, non_specials, self_caught, traded_only, this_server, frame, favorites, duplicates
`diff_only`	boolean	optional	Only show what's different between you and the other user, hiding "Both have" and "Neither have" -…
`collection`	subcommand		Show the collection of a specific countryball.
`countryball`	string	optional	The countryball you want to see the collection of
`ephemeral`	boolean	optional	Whether or not to send the command ephemerally.

/ballsbux

Currency commands

Default permission: anyone in the server, unless roles restrict it
Runs in: server, bot DM
Installs: server install

option	type		description
`balance`	subcommand		Check your balance.
`give`	subcommand		Give money to a player.
`user`	user	required	The player you want to give money to.
`amount`	integer	required	The amount to give.
`daily`	subcommand		Claim your daily reward. Claim on consecutive days to grow your streak.
`sell`	subcommand		Sell one of your countryballs for currency.
`countryball`	string	required	The countryball you want to sell.
`special`	string	optional	Filter the autocomplete to a special event. Ignored afterwards.
`history`	subcommand		See where your ballsbux came from and went.
`period`	integer	optional	How far back to look. Defaults to the last 30 days.choices: Last 7 days, Last 30 days, Last 90 days, Last year
`filter`	string	optional	Only show one kind of movement. Defaults to everything.choices: Everything, Income only, Spending only, Catch bounties, Daily rewards, Selling, Shop purchases, Auctions, Battle wagers, Trades and gifts
`shop`	subcommand group		Spend your ballsbux on upgrades
`view`	subcommand		See what the shop sells and your balance.
`reroll`	subcommand		Reroll the stat bonuses of one of your countryballs.
`countryball`	string	required	The countryball whose ATK/HP bonuses you want to reroll.
`special`	string	optional	Filter the results of autocompletion to a special event. Ignored afterwards.
`catchphrase`	subcommand		Buy a custom catch phrase, shown under your catch messages.
`phrase`	string	required	Your new catch phrase. Buying again replaces the old one.
`spawnboost`	subcommand		Boost countryball spawns for the whole server.
`rarityboost`	subcommand		Boost the chance of rare specials for the whole server.
`specialboost`	subcommand		Boost your own chance of rare specials for a while.
`guaranteedspecial`	subcommand		Guarantee your next catch has a special background.
`rarespawn`	subcommand		Make the next spawn in this server a rare one.
`traderspawnboost`	subcommand		Boost the wandering tradesman's own chance to appear in this server.
`traderdiscount`	subcommand		Discount the wandering tradesman's wares in this server for a while.
`mytraderdiscount`	subcommand		Buy a personal discount on your own wandering tradesman purchases.
`traderrarity`	subcommand		Make the wandering tradesman favour rarer countryballs in this server for a while.
`streaksaver`	subcommand		Rescue a daily streak you just broke by missing a day.
`streakfreeze`	subcommand		Buy a streak freeze that protects your daily streak in advance.
`favoriteslot`	subcommand		Buy extra favorite countryball slots. Stackable.

/battle

Battle countryballs with other players

Default permission: anyone in the server, unless roles restrict it
Runs in: server
Installs: server install

option	type		description
`deck`	subcommand group		Save and reuse battle teams
`save`	subcommand		Save your current battle team as a reusable deck.
`name`	string	required	A name for this deck. Reusing a name overwrites it.
`build`	subcommand		Put a deck together without starting a battle.
`name`	string	required	The deck to build. An existing name opens that deck for editing.
`special`	string	optional	Start the picker filtered to this special. You can change it in the picker.
`load`	subcommand		Load one of your saved decks into your current battle.
`name`	string	required	Which saved deck to load.
`list`	subcommand		See your saved battle decks.
`delete`	subcommand		Delete one of your saved decks.
`name`	string	required	Which deck to delete.
`view`	subcommand		See the balls and total power of one of your saved decks.
`name`	string	required	Which deck to view.
`challenge`	subcommand group		Post and accept open battle challenges
`create`	subcommand		Post an open challenge anyone can accept.
`deck`	string	required	The saved deck to battle with (also sets the team size).
`wager`	integer	optional	Currency each side stakes; the winner takes the pot. 0 = friendly.
`buffs`	boolean	optional	Allow special buffs.
`duplicates`	boolean	optional	Allow duplicate countries.
`abilities`	boolean	optional	Enable ball abilities (if allowed by the bot admins).
`manpower`	integer	optional	Manpower each side gets to spend on abilities. Leave blank for the default.
`list`	subcommand		Browse open challenges anyone can accept.
`size`	integer	optional	Only show challenges of this team size.
`max_wager`	integer	optional	Only show challenges whose wager is at or below this.
`abilities`	boolean	optional	Only show challenges with abilities on (true) or off (false).
`accept`	subcommand		Accept an open challenge with one of your saved decks.
`challenge_id`	integer	required	The challenge number (see /battle challenge list).
`deck`	string	required	Your saved deck to battle with.
`cancel`	subcommand		Cancel one of your open challenges and refund the wager.
`challenge_id`	integer	optional	The challenge to cancel. Omit to cancel your most recent open one.
`mine`	subcommand		See the challenges you've posted.
`start`	subcommand		Begin a battle with the chosen user.
`user`	user	required	The user you want to battle with
`duplicates`	boolean	optional	Whether or not you want to allow duplicates in your battle
`buffs`	boolean	optional	Whether or not you want to allow buffs in your battle
`amount`	integer	optional	The amount of countryballs needed for the battle. Minimum is 3, maximum is 10.
`abilities`	boolean	optional	Whether or not ball abilities are enabled for this battle (if allowed by the bot admins).
`wager`	integer	optional	Currency each player stakes; the winner takes the pot. Refunded on a draw. 0 = friendly.
`manpower`	integer	optional	Manpower each side gets to spend on abilities. Leave blank for the default.
`random`	subcommand		Battle someone with every setting and both teams picked at random - just confirm.
`user`	user	required	The user you want to battle with
`wager`	integer	optional	Currency each player stakes; the winner takes the pot. Refunded on a draw. 0 = friendly.
`special`	string	optional	Draw both teams from this special only. Both players need enough of them.
`ai`	subcommand		Battle Ballsdex itself. It builds its team after seeing yours, and picks counters.
`difficulty`	string	optional	How hard Ballsdex tries to counter your deck.choices: Easy, Normal, Hard, Nightmare
`amount`	integer	optional	How many countryballs each side fields. Minimum is 3, maximum is 10.
`deck`	string	optional	Start from one of your saved decks instead of picking from scratch.
`buffs`	boolean	optional	Whether special buffs apply to your team.
`special`	string	optional	Start the picker filtered to this special. You can change it in the picker.
`manpower`	integer	optional	Manpower each side gets to spend on abilities. Leave blank for the default.
`ai_history`	subcommand		Show your record against Ballsdex.
`difficulty`	string	optional	Only show battles at this difficulty.choices: Easy, Normal, Hard, Nightmare
`add`	subcommand		Add a countryball to the battle plan.
`countryball`	string	required	The countryball you want to add to your proposal
`special`	string	optional	…
`remove`	subcommand		Remove a countryball from what you proposed in the ongoing battle plan.
`countryball`	string	required	The countryball you want to remove from your proposal
`special`	string	optional	…
`cancel`	subcommand		Cancel your ongoing battle in this channel.
`history`	subcommand		Show your battle history.
`sorting`	string	optional	The sorting order of your battles.choices: Newest, Oldest
`opponent`	user	optional	The user you want to filter your battle history with.
`days`	integer	optional	Retrieve battle history from the last x days at most.
`stats`	subcommand		Show battle stats for yourself or another user.
`user`	user	optional	The user whose stats you want to see. Defaults to yourself.
`leaderboard`	subcommand		Show the top 10 players by battle wins, across all servers the bot is in.
`abilities`	subcommand		See a countryball's battle abilities.
`countryball`	string	required	The countryball whose battle abilities you want to see.

/trade

…

Default permission: anyone in the server, unless roles restrict it
Runs in: server
Installs: server install

option	type		description
`start`	subcommand		Start trading with someone.
`user`	user	required	The user you want to trade with.
`add`	subcommand		Add a countryball to your trade proposal. You must have a trade open.
`countryball`	string	required	The countryball you are adding to your trade.
`special`	string	optional	The special you want to filter the countryball by.
`remove`	subcommand		Remove a countryball from your trade proposal. You must have a trade open.
`countryball`	string	required	The countryball you are removing from your trade.
`special`	string	optional	The special you want to filter the countryball by.
`history`	subcommand		Show your trade history.
`sorting`	string	optional	The sorting order of your trades.choices: Newest, Oldest
`trade_user`	user	optional	The user you want to filter your trade history with.
`days`	integer	optional	Retrieve trade history from the last x days at most.
`countryball`	string	optional	The countryball you want to filter the trade history by.
`special`	string	optional	The special you want to filter the trade history by.
`group`	string	optional	The group you want to filter the trade history by.
`currency`	boolean	optional	Only show trades that included ballsbux
`filter`	string	optional	Only show trades involving countryballs matching a specific filter.choices: only_specials, non_specials, self_caught, traded_only, this_server, frame, favorites, duplicates
`bulk_add`	subcommand		Bulk add countryballs to the ongoing trade, with paramaters to aid with searching.
`countryball`	string	optional	The countryball you would like to filter the results to
`sort`	string	optional	Choose how countryballs are sorted. Can be used to show duplicates.choices: alphabetic, catch_date, rarity, special, health, attack, health_bonus, attack_bonus, stats_bonus, total_stats, catch_time, duplicates
`reverse`	boolean	optional	Reverse the sorted results.
`special`	string	optional	Filter the results to a special event
`filter`	string	optional	Filter the results to a specific filterchoices: only_specials, non_specials, self_caught, traded_only, this_server, frame, favorites, duplicates
`group`	string	optional	Filter the results to a specific group
`cancel`	subcommand		Cancel your active trade.

/auction

Global, channel-less auction house - list countryballs and bid on anyone else's

Default permission: anyone in the server, unless roles restrict it
Runs in: server, bot DM
Installs: server install, user install

option	type		description
`watch`	subcommand group		Get notified when a matching auction is listed
`add`	subcommand		Get notified when a new auction matching this is listed.
`ball`	string	optional	Notify me when this countryball gets auctioned.
`special`	string	optional	Notify me when this special background gets auctioned.
`is_special`	boolean	optional	Only match items that have any special (True) / that have no special (False). Leave unset to match…
`max_price`	integer	optional	Only notify me when the opening bid is at or below this. Leave unset for any price.
`remove`	subcommand		Stop watching for something.
`watch`	integer	required	The watch to remove.
`list`	subcommand		See what you're currently watching for.
`sell`	subcommand		List one of your countryballs in the global auction house.
`ball`	string	required	The countryball from your own collection to put up for auction.
`duration`	integer	required	How long the auction should run for (30m-24h, Patreon supporters up to 7 days).
`special`	string	optional	Filter the countryball autocomplete to a specific special background. Ignored afterwards.
`unit`	string	optional	Whether 'duration' is in minutes, hours or days (default: hours).choices: Minutes, Hours, Days
`min_bid`	integer	optional	The minimum opening bid (default: 1).
`min_increment`	integer	optional	The minimum raise per bid (default: 1).
`buy_now`	integer	optional	Instant-win price - a bid at or above this ends the auction immediately.
`reserve_price`	integer	optional	Hidden minimum sale price - if the highest bid doesn't reach it, the item stays with you. (Patreon…
`multi`	subcommand		List several of your countryballs as one lot in the global auction house.
`duration`	integer	required	How long the auction should run for (30m-24h, Patreon supporters up to 7 days).
`unit`	string	optional	Whether 'duration' is in minutes, hours or days (default: hours).choices: Minutes, Hours, Days
`min_bid`	integer	optional	The minimum opening bid for the whole lot (default: 1).
`min_increment`	integer	optional	The minimum raise per bid (default: 1).
`buy_now`	integer	optional	Instant-win price - a bid at or above this ends the auction immediately.
`reserve_price`	integer	optional	Hidden minimum sale price - if the highest bid doesn't reach it, the lot stays with you. (Patreon…
`countryball`	string	optional	Only offer this countryball in the picker.
`special`	string	optional	Only offer countryballs with this special background in the picker.
`sort`	string	optional	How the countryballs are ordered in the picker. Can be used to show duplicates.choices: alphabetic, catch_date, rarity, special, health, attack, health_bonus, attack_bonus, stats_bonus, total_stats, catch_time, duplicates
`filter`	string	optional	Only offer countryballs matching this filter in the picker.choices: only_specials, non_specials, self_caught, traded_only, this_server, frame, favorites, duplicates
`list`	subcommand		Browse and search active auctions across the whole bot.
`ball`	string	optional	Only show auctions for this countryball species.
`special`	string	optional	Only show auctions for this special background.
`is_special`	boolean	optional	Only show auctions for items with any special background.
`is_frame`	boolean	optional	Only show auctions for items caught with a special frame.
`seller`	user	optional	Only show auctions listed by this player.
`sort`	string	optional	How to order the results (default: ending soonest).choices: Ending soonest, Newly listed, Price: low to high, Price: high to low, Buy now: low to high, Buy now: high to low, Item count: most to fewest, Item count: fewest to most
`no_bids_only`	boolean	optional	Only show auctions that haven't received a bid yet.
`lot_type`	string	optional	Only show single-item auctions, only multi-item lots, or both (default: both).choices: Lots only, Single only, Mixed (both)
`view`	subcommand		See the full details of one auction.
`auction_id`	string	required	The auction to inspect, e.g. 19C.
`bid`	subcommand		Place a bid on an active auction.
`auction_id`	string	required	The auction to bid on, e.g. 19C.
`amount`	integer	required	Your bid amount.
`max_bid`	integer	optional	Optional: auto-bid up to this amount as others outbid you, without you coming back each time.
`mine`	subcommand		See your own auctions - active and past.
`status`	string	optional	Only show auctions with this outcome. Shows everything by default.choices: Ongoing, Sold, Unsold
`bids`	subcommand		See auctions you've placed a bid on.
`all`	boolean	optional	Include auctions that have already ended. Off by default (active only).
`feature`	subcommand		Pay to post an auction to the featured-auctions channel.
`auction_id`	string	required	The auction to feature, e.g. 19C.
`price`	subcommand		See what this countryball has actually sold for in past auctions.
`ball`	string	required	The countryball to look up past sales for.
`special`	string	optional	Only count sales of items with this special background. Overrides 'filter'.
`filter`	string	optional	Whether to count sales of items that had a special background. Defaults to excluding them.choices: Exclude specials (default), Include specials
`days`	integer	optional	How far back to look, in days. Defaults to the configured window.
`stats`	subcommand		See your auction house history - as a seller and as a bidder.

Commands documented by Ballsdex

No vendor documentation has been read for this app.

What changed

2026-09-07 First observed 2026-09-07

Full observation history