# 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>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://sdk-doc.tyrads.com/iframe/overview/currencies.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
