Show XMemo expenses
list_ledger_transactionsRead-onlyIdempotent
Search past expenses and purchases in your personal ledger. Filter by date, category, amount, or transaction type to answer finance questions.
Instructions
Show XMemo Ledger records. Call this when the user asks about past expenses, purchases, or spending history, or before answering a finance question that depends on recorded transactions. For item searches use query and leave currency blank unless a currency was requested.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum number of results to return. | |
| query | No | Natural-language question or search text. | |
| scope | No | Optional scope that narrows memory access; leave blank for the token default. | |
| bucket | No | Memory bucket or namespace to read from or write to; use % only for tools that support wildcard reads. | % |
| offset | No | Number of matching records to skip for pagination. | |
| date_to | No | Only include ledger transactions on or before this YYYY-MM-DD date. | |
| category | No | Optional spending category, such as food, transport, or electronics. | |
| currency | No | Currency code or label, such as CNY, RMB, JPY, yen, or USD. For ledger search/list tools, leave blank unless the user explicitly requested one currency; labels are normalized to codes. | |
| date_from | No | Only include ledger transactions on or after this YYYY-MM-DD date. | |
| max_amount | No | Only include ledger transactions with amount less than or equal to this value. | |
| min_amount | No | Only include ledger transactions with amount greater than or equal to this value. | |
| output_json | No | Return a machine-readable JSON response instead of a human-readable summary. | |
| transaction_type | No | Optional ledger type filter: expense, income, refund, or transfer. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |