# Coins

> The primary currency — earned from events, spent in the marketplace, tuned with coin rules.

Source: https://docs.hatched.live/docs/concepts/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](/docs/concepts/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.

## Related

- [Marketplace](/docs/concepts/marketplace) — where coins get spent.
- [Tokens](/docs/concepts/tokens) — secondary currencies alongside coins.
- [Configure rules](/docs/guides/configure-rules) — tuning coin rules and caps.
- [Best practices](/docs/guides/best-practices) — designing an economy that doesn't reward grinding.