Coins

Coins are the buddy's currency. They're earned automatically from events you send, according to the coin rules you configure. Users spend them in the marketplace.

What a coin rule is

Each coin rule binds an event type (lesson_completed, daily_login) to an amount. Optional caps and multipliers shape the economy:

• Daily cap — maximum coins of this type earned per UTC day.
• Weekly cap — same, weekly.
• Multiplier — for streak holders or premium users.
• Total limit — one-shot; useful for "first-10-lessons" bonuses.

Example

lesson_completed  → +10 coins (daily cap: 50)
streak_7          → +100 coins (one-time)
checkout_complete → +500 coins (premium audience only)

How to set it up

1. List the events you already fire in your product that deserve a reward.
2. Attach an amount and optional daily cap to each.
3. Add streaks or multipliers to reward long-term play.
4. Watch the Economy Health page on the dashboard.

Gotchas

• Without daily caps, coin supply inflates fast. A user grinding 200 lessons on day one should not break your marketplace.
• Balance coin earnings against marketplace prices. If nothing costs more than a week's earnings, coins become invisible.
• Coins always emit coin.earned webhooks — subscribe if you need to mirror the ledger into your own system.