> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.offerzy.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Currency and rewards

> Name your currency, set its exchange rate and run reward boost events.

The offerwall shows every reward in your own currency. Set it up in the placement's **Settings** tab.

<ParamField body="Offerwall title" type="string" required>
  Shown at the top of the offerwall, for example "Earn Coins".
</ParamField>

<ParamField body="Currency name" type="string" required>
  The plural form, as in "250 Coins".
</ParamField>

<ParamField body="One unit" type="string" required>
  The singular form, as in "1 Coin".
</ParamField>

<ParamField body="Units per $1" type="number" required default="1000">
  How many units of your currency equal one US dollar of your earnings. Any number above 0, up to 1,000,000.
</ParamField>

<ParamField body="Round currency to whole numbers" type="boolean" default="on">
  1,250.4 becomes 1,250 and 1,250.7 becomes 1,251.
</ParamField>

<ParamField body="Show the Surveys tab" type="boolean">
  Adds survey offers to the offerwall. Survey earnings are paid on Net 60; see [Payments](/payments).
</ParamField>

## How rewards are calculated

```text theme={null}
reward = your earnings in USD × units per $1 × event multiplier (during an event)
```

| Your earnings | Units per \$1 | Reward shown and sent in the postback |
| - | - | - |
| \$1.50 | 1,000 | 1,500 Coins |
| \$1.50 | 100 | 150 Gems |
| \$0.40 | 1,000 | 400 Coins |

A reward is fixed when the user starts the offer. If you change the exchange rate, offers already in progress keep the reward the user was shown.

## Reward boost events

Use the placement's **Events** tab to multiply rewards for a limited time, for example a 2× weekend. Choose a name, a multiplier (1.5×, 2× or 3×) and a start and end time.

* The boost applies to offers users start while the event runs.
* Users see the boosted reward on the offerwall, and the postback carries the boosted `reward`.
* Your earnings in USD don't change: the extra currency comes from your own economy.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.