Revenue Metrics

Track consolidated revenue across your Stripe accounts.

Setup

1. Store your Stripe key: ~/.config/stripe/api_key
2. Edit the ACCOUNTS dict in scripts/stripe-metrics.py with your Stripe account IDs
3. Run metrics:

python3 {baseDir}/scripts/stripe-metrics.py --period today    # today vs yesterday
python3 {baseDir}/scripts/stripe-metrics.py --period week     # last 7d vs prior 7d
python3 {baseDir}/scripts/stripe-metrics.py --period month    # last 30d vs prior 30d
python3 {baseDir}/scripts/stripe-metrics.py --period all      # all time

Output is JSON: gross revenue, refunds, net revenue, transaction count, and period-over-period growth %.

Nightly Deep Dive Workflow

1. Run --period today for the daily snapshot (⚠️ use --period yesterday if running at 3 AM)
2. Run --period month for trend context
3. Update your daily review doc with final revenue numbers
4. Write findings to memory/YYYY-MM-DD.md under "## Revenue Review"
5. Propose next day's plan based on what's working
6. Send the user a brief summary

Key Metrics to Track

• Daily net revenue — the scoreboard
• Per-account breakdown — which products are pulling weight
• Period growth % — accelerating or decelerating
• Transaction count — volume vs ticket size trends

Customization

Edit scripts/stripe-metrics.py to add your Stripe accounts:

ACCOUNTS = {
    "my_product": "acct_XXXX",
    "my_saas": "acct_YYYY",
}

The script reads your Stripe key from ~/.config/stripe/api_key.