Docs / Currency

Currency

Server currencies track member balances for auctions and shop purchases. One currency is free; additional currencies require Server Premium.

Create a currency

By default, Discord makes /currency commands available to members with Manage Server. You can also manage currencies from your server’s Currency Settings page in the dashboard.

Run /currency create name:coins in your server. Replace coins with your currency name, symbol, or emoji.
Optionally choose side (left or right), number_locale (number format), and integer_only (whole numbers only). The defaults are left, en-US, and decimals allowed.
Check the confirmation. The first currency becomes the server’s default currency.
Run /currency edit action:add target:@member amount:100 to give a member 100 units. Replace @member with the intended member.
Run /profile user:@member to check the balance. The user option is required; select yourself to see your own balances.

Change and view balances

`/currency edit`

Choose an action, target, and amount. add increases the balance, subtract reduces the balance, and set replaces the balance. A role target applies the change to each member with that role.

`/currency list`

Show saved member balances, highest first.

`/currency info`

Show the currency settings, total balance across members, and number of holders.

The currency option on /currency edit, /currency list, and /currency info selects a specific currency. If you omit the option, Prize Bot uses the default currency.

Change currency settings

Open your server in the dashboard, then open Currency Settings and select Edit beside a currency. Save after changing the settings.

Symbol / Name and Position

Choose the text shown with an amount and whether the text appears before or after the number, such as $100 or 100 coins.

Number Locale

Choose the separators used in amounts. For example, en-US displays 9,000,000.00 and de-DE displays 9.000.000,00. The dashboard shows a preview.

Integer only

Require whole-number amounts instead of decimal amounts.

Default currency

The first currency is the default. To change the default, select Set Default beside another currency. Each currency keeps its own balances.

The older /settings currency command also updates the default currency.

Delete a currency

Run /currency delete and select the currency, or use Delete on the Currency Settings page. The deleted currency’s balances become inaccessible. If other currencies exist, choose another default before deleting the current default.