# Coin Rewards

In order to create a coin reward you will need to have Coin contracts available in your account. You can either **create a coin yourself** or **import an existing coin contract** in the dashboard.

{% content-ref url="/pages/v9irFIL9s35iygXRNtIV" %}
[Coins](/campaign-managers/coins.md)
{% endcontent-ref %}

### Dashboard configuration

A coin reward is configured in the dashboard and requires a **title, description** and optionally an **image** to display in the widget user interface.

<figure><img src="/files/BGjfH4HD2Pi9zFs0oNVT" alt=""><figcaption><p>Example of a Coin Reward where 500 points can be redeemed for 5000 THX-DEMO coins.</p></figcaption></figure>

#### Coin

Select the Coin Contract for this reward. If you select an **imported** or **limited supply coin**, make sure to transfer enough coins to the pool in order to let your audience redeem them for points. You can find your pool address in the pool card on the pools overview page.

#### Coin Amount

Specify the amount of coins transferred to the user that redeemed the amount of points specific in *point price*.

#### Point Price

Specify the amount of points required as payment for the coin reward. Points will be destroyed upon redemption.

#### Expiration

...

#### Limits

...

{% hint style="info" %}
**Tip:** The amount of points required for a coin reward payment does not necessarily have to be equal.&#x20;
{% endhint %}

### Widget appearance

<figure><img src="/files/WTsXowz7JA7sDTEYS0ro" alt="" width="375"><figcaption><p>Example of a how a coin reward with a supply of 100 allows to redeem 500 THX-DEMO for 5000 points</p></figcaption></figure>

Next to the coin reward title the amount of coins transferred after a **5000 points** redemption (500 THX-demo) is shown.&#x20;

The coin supply limit will be updated after every redemption and the <mark style="color:green;">green color</mark> will change in <mark style="color:yellow;">yellow</mark> when there is less than **25% of the supply left** and to <mark style="color:red;">red</mark> if there is less than **10% left**.

<figure><img src="/files/xeaGXi56E6FSCNP7oFIa" alt="" width="375"><figcaption><p>Example of the confirmation modal shown after choosing to redeem 5000 points.</p></figcaption></figure>

After confirming the redemption in the confirmation modal the system will verify if in the meantime the perk has **expired** or the **supply limit** has been hit. If the user balance is sufficient a transfer of ERC20 from the pool to the known wallet address of the user will be transferred.&#x20;

After confirmation of the transaction the point price will be subtracted of the users point balance and the token will be visible in the users wallet.


---

# 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://docs.thx.network/campaign-managers/rewards/coin-rewards.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.