> For the complete documentation index, see [llms.txt](https://cozy-1.gitbook.io/dev-example2/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cozy-1.gitbook.io/dev-example2/currency/placeholders-placeholderapi.md).

# Placeholders (PlaceholderAPI)

ManticCurrency includes native integration with PlaceholderAPI, allowing you to display player economy statistics anywhere on your server—including scoreboards, tab lists, and chat messages.\
\
To use these, ensure PlaceholderAPI is installed on your server. All placeholders below use the `%currency_...%` prefix.

#### 💰 Balance & Wallet Placeholders

| **Placeholder**           | **Description**                                            |
| ------------------------- | ---------------------------------------------------------- |
| `%currency_amount%`       | Returns the player's formatted balance (e.g., 1,500).      |
| `%currency_amount_raw%`   | Returns the player's raw balance number (e.g., 1500).      |
| `%currency_amount_short%` | Returns the player's balance in short format (e.g., 1.5k). |

#### 📈 Lifetime Statistics

| **Placeholder**                | **Description**                                            |
| ------------------------------ | ---------------------------------------------------------- |
| `%currency_total_redeemed%`    | Returns total currency items redeemed by the player.       |
| `%currency_total_purchases%`   | Returns the total count of items purchased from the shop.  |
| `%currency_total_spent%`       | Returns total currency spent in the shop (formatted).      |
| `%currency_total_spent_raw%`   | Returns total currency spent as a raw number.              |
| `%currency_total_spent_short%` | Returns total currency spent in short format (e.g., 150k). |

#### 🎁 Daily Reward Placeholders

| **Placeholder**                   | **Description**                                                                    |
| --------------------------------- | ---------------------------------------------------------------------------------- |
| `%currency_daily_available%`      | Returns "Yes" or "No" based on daily reward availability.                          |
| `%currency_daily_time_remaining%` | Returns the countdown until the next reward (e.g., "02h 15m 30s" or "Available!"). |
| `%currency_daily_progress_bar%`   | Displays a dynamic visual progress bar of the daily reward cooldown.               |

#### 🛒 Recent Purchase History

| **Placeholder**                     | **Description**                                                   |
| ----------------------------------- | ----------------------------------------------------------------- |
| `%currency_last_purchase_item%`     | Returns the name of the last item purchased.                      |
| `%currency_last_purchase_cost%`     | Returns the cost of the last purchased item.                      |
| `%currency_last_purchase_category%` | Returns the shop category the last item was purchased from.       |
| `%currency_last_purchase_time_ago%` | Returns how long ago the purchase was made (e.g., "2 hours ago"). |