- name
- wallet-api
- description
- 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.
Wallet API Skill
Interact with the BudgetBakers Wallet personal finance API.
Prerequisites
- Premium Wallet plan required for API access
- API Token from web.budgetbakers.com/settings/apiTokens
- Set
WALLET_API_TOKENenvironment variable
Quick Start
export WALLET_API_TOKEN="your_token_here"
./scripts/wallet-api.sh meAPI Reference
See references/api-reference.md for:
- Authentication details
- Rate limiting (500 req/hour)
- Query filter syntax (text and range filters)
- Pagination parameters
- Data synchronization behavior
- Agent hints
Available Commands
| Command | Description |
|---|---|
me | Current user info |
accounts | List accounts |
categories | List categories |
records | List transactions |
budgets | List budgets |
templates | List templates |
Query Parameters
All list endpoints support:
limit(default 30, max 100)offset(default 0)
Filter Examples
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"Filter Prefixes
| 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 |
Common Workflows
Get Account Balances
./wallet-api.sh accountsList Categories for Organization
./wallet-api.sh categoriesRecent Spending
./wallet-api.sh records "recordDate=gte.2025-02-01&limit=100"Filter by Payee
./wallet-api.sh records "payee=contains-i.amazon"Data Sync Considerations
- Initial sync returns 409 Conflict — wait and retry
- Recent app changes may not appear immediately
- Check
X-Last-Data-Change-Atheader for freshness
Rate Limit Handling
Watch for:
429 Too Many Requestswhen exceeding 500/hourX-RateLimit-Remainingheader- Add
agentHints=truefor rate limit warnings