Ballsdex
Collecting
Ballsdex · commands
Ballsdex commands
5 most-used commands, as reported by Discord's App Directory on 2026-10-08
Command names and source descriptions are shown in their original language.
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. |
regime | string | optional | Filter the list by a specific regime. |
economy | string | optional | Filter the list by a specific economy. |
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 |
countryball | string | optional | Only look at a specific countryball. |
special | string | optional | Only look at a specific special event. |
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 |
group | string | optional | Only look at a specific group. |
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 |
group | string | optional | Filter the selection to a specific group |
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 |
group | string | optional | The group you want to count |
regime | string | optional | The regime you want to count |
economy | string | optional | The economy you want to count |
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`. |
min_count | integer | optional | Only show results you own at least this many of. |
reverse | boolean | optional | Show your least duplicated countryballs or specials first instead. |
group | string | optional | Filter the results by a specific group. |
special | string | optional | Filter the results by a specific special event, can only be used with `countryballs`. |
regime | string | optional | Filter the results by a specific regime. |
economy | string | optional | Filter the results by a specific economy. |
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 |
group | string | optional | Filter the results of the comparison to a specific group. |
regime | string | optional | Filter the results of the comparison to a specific regime. |
economy | string | optional | Filter the results of the comparison to a specific economy. |
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 |
filter | string | optional | Filter the collection by a specific filter.choices: only_specials, non_specials, self_caught, traded_only, this_server, frame, favorites, duplicates |
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 | Browse the shop, buy items, and check 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. |
/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. |
/ballspass
Earn XP from daily and weekly tasks, level up, and claim rewards
- Default permission
- anyone in the server, unless roles restrict it
- Runs in
- server, bot DM
- Installs
- server install, user install
| option | type | description | |
|---|---|---|---|
view | subcommand | View your Ballspass level and XP progress | |
user | user | optional | View another player's battlepass (optional) |
ephemeral | boolean | optional | Only show the card to you (default: visible to everyone) |
tasks | subcommand | View your daily and weekly Ballspass tasks | |
task | integer | optional | Pick one task to see exactly what counts toward it |
rewards | subcommand | Browse the Ballspass reward track | |
premium | subcommand | View Ballspass premium perks and purchase | |
gift | subcommand | Redeem a premium gift you bought onto another player | |
user | user | required | The player who should receive Ballspass premium |
unlock | subcommand | Unlock this season's Ballspass with ballsbux, so you start earning | |
leaderboard | subcommand | View the Ballspass XP leaderboard | |
scope | string | optional | Which board to show — defaults to the full seasonchoices: Season (all players), This week, Friends only |
history | subcommand | View the Ballspass rewards you've earned this season | |
notifications | subcommand | Choose where Ballspass reward notifications are sent | |
preference | string | required | Where to deliver task-complete and reward notificationschoices: Last channel (fall back to DM), Direct message only, Off (no notifications) |
reroll | subcommand | Premium: swap one of today's daily tasks for a new one |
/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. |
Commands documented by Ballsdex
No vendor documentation has been read for this app.
What changed
- 2026-10-08 /ballspass entered the most-used set /battle no longer among the most-used since 2026-10-08 /balls edited /ballsbux edited
- 2026-09-07 First observed 2026-09-07
Sources and dated records
The facts above describe the current catalog entry. These dated source records also include earlier checks and may describe older values. A source date applies only to that record; it does not refresh every field on the page.
Source notes are shown in their original language.
Commands reported by Discord Latest record
5 most-used commands with bodies, 5 ids listed
Discord's App Directory reports these as the application's most-used commands. It does not publish the full set.
https://discord.com/api/v9/application-directory-static/applications/999736048596816014
Recorded · Source retrieved · Confidence high · SHA-256 9ad0002758a4816176c9a944ec507addd06b738a6eb5ca74cf0154c5b5abfd10
5 most-used commands with bodies, 5 ids listed
Discord's App Directory reports these as the application's most-used commands. It does not publish the full set.
https://discord.com/api/v9/application-directory-static/applications/999736048596816014
Recorded · Source retrieved · Confidence high · SHA-256 1702a5f82c9ca1ff264885078194e9295dfee40df222710c4eb6e0db9a96dd4d