Offerwall Currency Settings: Set Up Your App Currency

How do you set up offerwall currency settings?

In your Sharklio dashboard, click Apps, click Manage next to your app, and open the Currency tab. Set the Currency name, the Conversion rate (how many units of your currency equal $1 of your earnings, before the split), Split to user (%), and Reward rounding, then click Save changes. The optional Bonus box on the same tab adds a time-limited boost, and the currency icon is uploaded on the Design tab. Every reward on your wall and every {reward} in your postbacks comes from these settings.

This page covers the settings themselves: exact labels, limits, defaults, and where users see the result. To decide which rate and split to choose, read How to set your virtual currency exchange rate. Labels and limits were checked in the dashboard on November 2, 2026.

What each currency setting does

The Add a new app form has the same four currency fields, filled in with the defaults below. The Bonus box only appears on the Currency tab once the app exists.

The settings apply to the whole app: the offerwall (link, iframe or floating button), the Offers API, and the mobile SDKs, which open the same wall.

Step by step: set up your app currency

1. Click Apps in the sidebar under Publish, then Manage next to the app. For a new app, click New app; How to create your first app covers that form.
2. Open the Currency tab.
3. Currency name. Type what your users collect, for example Coins, Points or Gems. Emoji and punctuation are rejected. Type the plural form. When a reward is exactly 1, the wall drops a plain plural “s” (“1 Coin”, “1 Point”), and names without an obvious singular, such as Cookies or Lives, stay as typed.
4. Conversion rate. Enter how many units equal $1 of your earnings, before the split, for example 1000. It must be more than 0, with up to 2 decimals. Leave out thousands separators: a comma counts as a decimal point, so “1,000” is rejected.
5. Split to user (%). A whole number from 1 to 100. As the hint says, “You are paid in USD either way.”
6. Reward rounding. Whole numbers for coins and points, or Up to 3 decimals for dollar balances. See the rounding section below.
7. Check the How your users are rewarded box. It shows what “Your user gets” for every $1 you earn, the reward for offers that pay you $0.050, $0.370 and $2.500, and a row where you type any payout. “0, offer hidden” means offers paying that little will not appear. With the Bonus switch on, the box includes the bonus.
8. Click Save changes. The dashboard confirms with “Saved.”
9. On the Design tab, under Images, click Upload next to Currency icon, pick a PNG, JPG, WebP or GIF (up to 3MB, or 2MB for a GIF), and click Save changes. Preview shows it on your wall; How to customize your offerwall design covers the rest of the tab.

The reward formula, with an illustrative example

The wall, the Offers API and every credit use this:

reward = payout × conversion rate × split to user / 100 × (1 + bonus / 100)
then rounded with your Reward rounding rule

payout is what you earn for one step of an offer, in US dollars, the same number that arrives as {payout}. The bonus is 0 when none is running. Each step is rounded on its own, the wall shows the sum of the rounded steps, and halves round up, so 2.5 becomes 3.

Illustrative example (sample figures only). A game sets Currency name Gems, Conversion rate 250, Split to user 80 and Whole numbers, so users get 200 Gems per $1 the game earns. One offer has two steps: “Install and play” pays the game $0.422 and “Reach level 10” pays $1.237.

Rounding the total would give 332 (1.659 × 200 = 331.8), one Gem more than the wall shows. That is expected: each step is credited and rounded as its own transaction, with its own {transaction_id} and postback. If the first step is credited during the bonus, the game’s server receives something like:

https://yourgame.example/postback?user=u_8812&tx=a41f0c9e7b2d58e3c6f1a0b9&status=1&reward=97&payout=0.422&currency=Gems&hash=...

If the second step is credited after the bonus ends, it arrives with the normal reward=247, even if the user started the offer during the bonus. The virtual currency calculator lets you try other rates and splits.

Rounding and decimals

• Whole numbers rounds to the nearest unit: the field hint’s example turns 16.65 into 17.
• Up to 3 decimals turns 0.0084 into 0.008.
• Offers that would give 0 are not shown. With Whole numbers, an offer needs at least 0.5 before rounding. At a rate of 10 and a 50% split, an offer paying you $0.09 gives 0.45 and is hidden, while one paying $0.10 gives 0.5 and shows as 1.
• Paying in dollars. The hints say “Paying in dollars? Use $.” for the name and “Set the conversion rate to 1 and choose up to 3 decimals.” At a 60% split, the two steps above would give 0.253 and 0.742, shown as “0.253 $”.
• Number format. The wall writes thousands with a comma (1,250 Gems). Postbacks send plain numbers with a dot, no thousands separator and no trailing zeros, such as 1250 or 0.253.

With three decimals, store balances in an exact decimal type, never a float. The MySQL manual says DECIMAL and NUMERIC are “used when it is important to preserve exact precision, for example with monetary data”, and the PostgreSQL docs recommend numeric “for storing monetary amounts and other quantities where exactness is required”. In Python, parse {reward} with the decimal module; its docs show binary floating point displaying 1.1 + 2.2 as 3.3000000000000003.

Add a time-limited bonus

The Bonus box on the Currency tab explains itself: “A temporary boost on top of your rate, paid from your own share. With a 10% bonus, a user who normally gets 100 Coins gets 110. Your payout from Sharklio does not change.” It has:

• An On/Off switch. The bonus only runs while it is on.
• Bonus percentage, 0 to 500. Turning the switch on without one gives “Set the bonus percentage, or turn the bonus off.”
• Repeat: Does not repeat, Every day, or Every week. A repeating bonus needs a start and an end; a daily window must last less than 24 hours, a weekly one less than 7 days.
• Bonus starts: empty starts it right away. Bonus ends: empty runs it until you turn it off; with an end, users see a live countdown.

Times are in your account’s time zone, and a repeating bonus keeps its local hours when clocks change; the guide to time zones in your reports shows where that zone is set. After saving, a badge shows the state, such as “Active now, ends today 22:00”, “Next: every day 18:00 to 22:00”, or “Ended”.

While it runs, the wall shows “+10% on every reward” (or your percentage), an Ends in countdown when you set an end, and the normal amount struck through before each boosted reward. A step gets the bonus only if it is credited while the bonus runs. The extra currency comes from your own share; Offerwall bonus events has the break-even math and timing advice.

Keep the countdown honest. The FTC staff report Bringing Dark Patterns to Light lists a “Baseless Countdown Timer”, a fake countdown clock that goes away or resets when it times out, as a dark pattern. The Sharklio countdown follows the real end you set, so do not stretch a bonus at the last minute or relaunch it the moment it ends.

Which values carry your currency in postbacks and the API

Some values are in your currency, for your users; others are in US dollars, for you.

• Credit {reward} as it arrives. The Rewards and currency docs say: “Add it to the user as it is, and never convert it again.” Recomputing from {payout} misses the bonus, per-step rounding, and later settings changes.
• Check the hash with the raw string. {hash} signs the transaction ID, user ID, reward and status, so turning 0.25 into 0.250 first breaks the match. See the postback docs.
• Treat {currency} as a label. It carries the name your app has when the postback is sent, so after a rename, a reversal of an older credit arrives with the new name.
• Credit once per {transaction_id}, as Prevent duplicate reward credits shows.

To test the chain, use Send a test postback in Integration status on the Integration tab. You pick a User ID, Status and Payout (USD), and the reward uses your current settings, including a running bonus: in the Gems example, a $1.00 test arrives as reward=200. The guide to Integration status covers that panel. Reports, Conversions shows a Reward column in your currency next to Payout in US dollars, and Build your own offerwall with an Offers API shows how to display reward_before_bonus on your own wall.

Changing your currency settings later

• After Save changes, the wall shows new amounts at once, and steps credited from then on use the new settings. Rewards already credited do not change, and neither do their reversals.
• The wall’s own totals (Earned today, Last 30 days, and Total earned in My rewards) add up amounts as credited, so they stay right.
• Your users’ balances live on your server, and Sharklio never touches them. If you change what a unit is worth, decide what happens to existing balances and tell users first.
• Each app has one currency. For a second one, add a second app; see Multiple apps in one publisher account.

If your currency also has a store price, Virtual economy design helps keep earned and bought currency in balance.

Frequently asked questions