Prize Bot
Docs / Currency

Currency

Server economy with multiple currencies, user balances, and auction integration.

Features

Multiple Currencies

Create multiple currencies per server with independent balances. Free servers get 1 currency, premium servers get unlimited.

Custom Formatting

Set your own symbol (emoji or text), position (left or right), and choose integer-only or decimal amounts.

User Balances

Track individual balances per currency for all server members. View with /profile.

Auction Integration

Auctions use your default currency. Enable "Use Currency" to deduct bids from balances.

Role Operations

Add, set, or subtract currency for everyone with a specific role at once.

Balance Leaderboard

View all users and their balances sorted by amount, per currency.

Commands

/currency create

Create a new currency for your server. The first currency becomes the default.

name The currency symbol or name (e.g., $, coins, credits)
side Left ($100) or right (100$) — optional, defaults to left
integer_only Only allow whole numbers, no decimals — optional
/currency edit

Modify currency balances for users or roles.

action Add, set, or subtract from balance
target A user or role to modify
amount The amount to add/set/subtract
currency Which currency to modify — optional, defaults to the server's default currency
/currency list

Display all users' balances sorted by amount.

currency Which currency to list — optional, defaults to the server's default currency
/currency info

Show details about a currency including total supply and number of holders.

currency Which currency to view — optional, defaults to the server's default currency
/currency delete

Delete a currency. Existing balances are archived but no longer accessible. You cannot delete the default currency while other currencies exist.

currency The currency to delete
/profile [user]

View a user's profile including balances for all currencies. Shows your own profile if no user specified.

Configuration

Use /currency create to create a currency, or manage currencies from the dashboard Currency Settings page.

  • Symbol Your currency symbol (e.g., $, coins, credits)
  • Position Left ($100) or right (100$) of the amount
  • Integer Only Only allow whole number amounts (no decimals)
  • Default Currency The first currency created becomes the default. Used automatically by auctions and other features.

/settings currency is also supported for backward compatibility and will update the default currency.

Multiple Currencies

Servers can have multiple independent currencies, each with their own symbol, formatting, and user balances. Free servers are limited to 1 currency. Premium servers can create unlimited currencies.

  • - Each currency has its own set of user balances
  • - One currency is marked as the default and is used automatically by auctions and other features
  • - Use the currency parameter on /currency edit and /currency list to target a specific currency
  • - /profile shows balances for all currencies

Ready to get started?

Add Prize Bot to your server.

Add to Discord