> For the complete documentation index, see [llms.txt](https://sdk-doc.tyrads.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://sdk-doc.tyrads.com/iframe/overview/currencies.md).

# Currencies

## 💰Currencies

The **Tyr SDK** supports multiple virtual currencies, allowing you to display campaign rewards across different currency types that match your app's economy (e.g., coins, gems, points, tickets).

#### 💪🏼 How It Works

Each placement in your app can be associated with **one or more virtual currencies**. When a `placementId` is provided during SDK initialization, the SDK filters and returns all currencies available for that specific placement — enabling users to see and earn multiple reward types simultaneously.

If no `placementId` is provided, the SDK will fall back to the default currency configured for your account.

#### 📌 Placement-Based Multi-Currency

A single placement can expose multiple currencies at once. This is useful when your app rewards users across several in-game economies simultaneously.

**Example:** A placement can be configured to reward users in both `coins` and `gems` at the same time, so users see all applicable reward units in a single SDK session.

| Placement ID | Currencies Available           |
| ------------ | ------------------------------ |
| `1`          | 🪙 Coins                       |
| `2`          | 🪙 Coins, 💎 Gems              |
| `3`          | 🪙 Coins, 💎 Gems, 🎟️ Tickets |
| *(none)*     | Default account currency       |

{% hint style="info" %}
💡**Pro Tip:** Configure placements with multiple currencies to maximize reward relevance. Users are more engaged when they earn currencies tied directly to the in-game economy of the screen they're currently on.
{% endhint %}

#### Example Usage

Use the `placementId` parameter to load the SDK with all currencies available for that placement:

```html
<!-- Load SDK for a placement that rewards users in both Coins and Gems -->
https://sdk.tyrads.com?token=<TOKEN>&placementId=1
```

#### 🖼️ Screenshots

<figure><img src="/files/BEaw0YL69412V3j1SQbe" alt=""><figcaption></figcaption></figure>