Interact with the BudgetBakers Wallet API for personal finance data. Use when the user needs to query accounts, categories, transactions (records), budgets, or templates from their Wallet app via the REST API. Requires WALLET_API_TOKEN environment variable.
Interact with the BudgetBakers Wallet personal finance API.
WALLET_API_TOKEN environment variableexport WALLET_API_TOKEN="your_token_here"
./scripts/wallet-api.sh me
See references/api-reference.md for:
| Command | Description |
|---|---|
me | Current user info |
accounts | List accounts |
categories | List categories |
records | List transactions |
budgets | List budgets |
templates | List templates |
All list endpoints support:
limit (default 30, max 100)offset (default 0)Recent transactions:
./wallet-api.sh records "recordDate=gte.2025-02-01&limit=50"
Amount range:
./wallet-api.sh records "amount=gte.100&amount=lte.500"
Text search:
./wallet-api.sh records "note=contains-i.grocery"
Category + date:
./wallet-api.sh records "categoryId=eq.<id>&recordDate=gte.2025-01-01"
| Prefix | Meaning |
|---|---|
eq. | Exact match |
contains. | Contains (case-sensitive) |
contains-i. | Contains (case-insensitive) |
gt. | Greater than |
gte. | Greater than or equal |
lt. | Less than |
lte. | Less than or equal |
./wallet-api.sh accounts
./wallet-api.sh categories
./wallet-api.sh records "recordDate=gte.2025-02-01&limit=100"
./wallet-api.sh records "payee=contains-i.amazon"
X-Last-Data-Change-At header for freshnessWatch for:
429 Too Many Requests when exceeding 500/hourX-RateLimit-Remaining headeragentHints=true for rate limit warnings