Wallet API

Wallet API Skill

Interact with the BudgetBakers Wallet personal finance API.

Prerequisites

1. Premium Wallet plan required for API access
2. API Token from web.budgetbakers.com/settings/apiTokens
3. Set WALLET_API_TOKEN environment variable

Quick Start

export WALLET_API_TOKEN="your_token_here"
./scripts/wallet-api.sh me

API 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

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

Common Workflows

Get Account Balances

./wallet-api.sh accounts

List Categories for Organization

./wallet-api.sh categories

Recent 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-At header for freshness

Rate Limit Handling

Watch for:

• 429 Too Many Requests when exceeding 500/hour
• X-RateLimit-Remaining header
• Add agentHints=true for rate limit warnings