Prize Bot
Docs / Currency

Currency

Server economy with multiple currencies, user balances, locale-aware number formatting, and auction/shop 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.

Number Locale Formatting

Choose a number format such as en-US for 9,000,000.00 or de-DE for 9.000.000,00.

User Balances

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

Auction and Shop Integration

Auctions and shop purchases can use server balances. Enable "Use Currency" on auctions to deduct winning 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
number_locale BCP 47 locale tag for separators and decimals, such as en-US, de-DE, fr-FR, or en-IN
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
  • Number Locale Uses standard locale tags for thousands and decimal separators, with previews in the dashboard
  • 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