Skip to content

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.

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)

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

minted - burned. A positive number means we’re accumulating unspent coins on user wallets: that’s the bonus liability.

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.

Every double-entry event zero-sums:

SUM(coin_ledger.amount GROUP BY event_id) = 0

The 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.

  • Date range (UTC)
  • Market (ISO-2, all)
  • User segment (e.g. VIP, new users)

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.
ActionEndpoint
Economy summaryGET /v1/admin/economy

Full details in API: Monetization.