📈 Analytics
View statistics, spending breakdowns, top expenses, and financial summaries.
On this page
get_statistics
SafeGet spending and income statistics for a period. Shows totals, averages, and trends.
Parameters
| Parameter | Type | Description |
|---|---|---|
| period? | string | today, week, month (default), year, or custom range |
| start_date? | string | Start date for custom range |
| end_date? | string | End date for custom range |
Examples
• Expenses: $45,000
• Income: $80,000
• Balance: +$35,000
• Average daily expense: $2,250
get_spending_by_category
SafeGet spending breakdown by category with percentages. Shows where your money goes.
Parameters
| Parameter | Type | Description |
|---|---|---|
| period? | string | Time period. Default: month |
| limit? | number | Top N categories. Default: 10 |
Examples
1. Food: $15,000 (33%) ████████░░
2. Transport: $8,000 (18%) ████░░░░░░
3. Entertainment: $6,000 (13%) ███░░░░░░░
4. Subscriptions: $3,500 (8%) ██░░░░░░░░
5. Other: $12,500 (28%) ██████░░░░
get_top_expenses
SafeGet the largest individual expenses for a period. Helps identify big spending.
Parameters
| Parameter | Type | Description |
|---|---|---|
| period? | string | Time period. Default: month |
| limit? | number | Top N expenses. Default: 5 |
Examples
1. Rent: $50,000 (01/01)
2. iPhone Case: $3,500 (01/15)
3. Restaurant: $3,200 (01/12)
4. Groceries: $2,800 (01/08)
5. Taxi: $2,500 (01/18)
compare_periods
SafeCompare spending between two periods. Shows increase/decrease and percentage change.
Parameters
| Parameter | Type | Description |
|---|---|---|
| period1? | string | First period (default: current month) |
| period2? | string | Second period (default: previous month) |
| category? | string | Compare specific category |
Examples
Expenses: $45,000 vs $52,000 (−13%)
Income: $80,000 vs $80,000 (0%)
By category:
• Food: +$2,000 (+15%)
• Transport: −$1,500 (−16%)
• Entertainment: −$7,500 (−56%)
get_financial_summary
SafeGet a complete financial overview: balances, debts, goals, budgets, and upcoming payments.
Examples
💰 Balance: $75,000
📊 Budgets: 3 active (2 on track, 1 exceeded)
🎯 Goals: 45% to Vacation, 30% to Car
🤝 Debts: owed to you $3,000, you owe $5,000
🔄 Next payments: Netflix (01/15), Gym (02/01)
This month: +$35,000 (income − expenses)
get_net_worth
SafeCalculate your net worth: total assets minus liabilities. Includes all wallets, goals savings, and debts.
Parameters
| Parameter | Type | Description |
|---|---|---|
| currency? | string | Convert all to this currency |
Examples
Assets:
• Wallets: $75,000
• Goals (saved): $55,000
• Owed to you: $3,000
Total assets: $133,000
Liabilities:
• You owe: $10,000
Total liabilities: $10,000
🔍 Data Quality
Find and fix data issues: uncategorized transactions, duplicates, and anomalies.
find_uncategorized
SafeFind transactions without a category. Returns suggestions for bulk categorization or creating automation rules.
Parameters
| Parameter | Type | Description |
|---|---|---|
| limit? | number | Max transactions to return. Default: 50 |
Examples
• Uber Eats - $1,200 (3 times)
• Yandex Go - $500 (5 times)
• ...
Suggestions:
1. Bulk assign category
2. Create rule "Uber Eats → Delivery"
find_duplicates
SafeFind potential duplicate transactions based on amount, wallet, time proximity, and description similarity.
- Same amount and wallet
- Within 5 minutes of each other
- Similar description (>80% match)
Parameters
| Parameter | Type | Description |
|---|---|---|
| days? | number | Days to analyze. Default: 30 |
Examples
1. "Coffee" $2.50 (01/15 10:05 and 10:07) - 95% confidence
2. "Groceries" $15.00 (01/18 14:30 and 14:31) - 90% confidence
Delete duplicates?
detect_anomalies
SafeFind unusual transactions that deviate significantly from your typical spending patterns. Uses statistical analysis (>2 standard deviations from mean).
Parameters
| Parameter | Type | Description |
|---|---|---|
| category? | string | Analyze specific category only |
| months? | number | Months for baseline calculation. Default: 3 |
Examples
1. "Restaurant" - $85.00 (usually ~$12.00, 7x average)
2. "Taxi" - $32.00 (usually ~$4.00, 8x average)
3. "Groceries" - $120.00 (usually ~$30.00, 4x average)
These may be errors or special cases.