Economy monitor
The Economy monitor at /analytics/economy is the finance dashboard for the coin economy. It tells you whether the ledger is balanced and how much bonus liability sits on the books.
Key metrics
Section titled “Key metrics”Coins minted (period)
Section titled “Coins minted (period)”Sum of positive coin credits into wallet_paid + wallet_bonus in the period. Broken down:
- From purchases (
source_iap_*,source_card_*,source_dlocal_*,source_pawapay_*,source_vas_*) - From promos (
source_promo) - From support grants (
source_support_grant) - From subscription bonuses (
source_subscription_bonus)
Coins burned (period)
Section titled “Coins burned (period)”Sum of negative movements out of the wallet accounts:
- From unlocks (
sink_unlock): episode purchases - From refunds (
sink_refund): money going back out - From fraud recoup (
sink_fraud): support deducts
Net coin flow
Section titled “Net coin flow”minted - burned. A positive number means we’re accumulating unspent coins on user wallets: that’s the bonus liability.
Bonus liability (running)
Section titled “Bonus liability (running)”The single most important finance number:
liability_bonus_coins = SUM(wallet_bonus balances across all users)liability_paid_coins = SUM(wallet_paid balances across all users)Bonus coins are effectively an interest-free loan against future engagement. Finance often treats them as a soft liability at $0.01 each × outstanding count.
Sink/source balance
Section titled “Sink/source balance”Every double-entry event zero-sums:
SUM(coin_ledger.amount GROUP BY event_id) = 0The dashboard runs this invariant on the current period. If any event fails to zero-sum, it’s a red banner at the top of the page. This should never happen; it means a code bug wrote an unmatched ledger entry. Escalate immediately.
Filters
Section titled “Filters”- Date range (UTC)
- Market (ISO-2, all)
- User segment (e.g. VIP, new users)
Reading the chart
Section titled “Reading the chart”Line chart with three series:
- Minted (green): running daily total
- Burned (orange)
- Liability (blue, right axis): cumulative outstanding bonus
Healthy trend: minted > burned consistently, liability rises steadily (users are engaging), no zero-sum breaches ever.
Alarms:
- Burned > minted for days: economy is deflating; user churn or too-generous promos.
- Liability spike without a matching mint spike: code bug or promo audit failure.
- Zero-sum breach: dev bug, drop everything.
API call
Section titled “API call”| Action | Endpoint |
|---|---|
| Economy summary | GET /v1/admin/economy |
Full details in API: Monetization.