Add an expense to the database.

List all expenses from the database within a date range (inclusive). If the list contains more than 50 items, it truncates the inline results to the first 50 and exports the full dataset to a downloadable CSV spreadsheet.

Summarize and breakdown expenses by columns or time units within a date range.

Delete expenses matching the provided filters. At least one filter must be provided to prevent accidental deletion of all records. All provided filters are combined using AND.

Update expenses matching the target filters with the specified values. At least one target filter and one update value must be provided. All provided filters are combined using AND.

Create one or more budget tracking limits. You can either pass single budget parameters or a list of budget dicts in 'budgets'.

List all budgets matching the optional filters. All provided filters are combined using AND.

Update budgets matching the target filters with the specified values. At least one target filter and one update value must be provided. All provided filters are combined using AND.

Delete budgets matching the target filters. At least one target filter must be provided. All provided filters are combined using AND.

Get the real-time spending status compared against active budgets on a given reference date. All provided filters are combined using AND.

Generate an analytical expense summary with a rich Matplotlib chart. At least one grouping dimension ('period' or 'group_by') is recommended.

Calculate a deterministic financial health score and feedback metrics.